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引言 
1 目的 


”一 项 计算 机 软件 的 筹划 、 研 制 及 实现 ,构成 一 个 软件 开发 项 目 . 一 个 软件 开发 项 目的 进行 ,一 般 需 要 
在 人 力 和 自动 化 资源 等 方面 作 重大 的 投资 .为 了 保证 项 目 开 发 的 成 功 ,最 经 济 地 花费 这 些 投资 ,并且 便 
于 运行 和 维护 ,在 开发 工作 的 每 一 阶段 ,都 需要 编制 一 定 的 文件 .这 些 文件 连同 计算 机 程序 及 数据 一 起 ， 
构成 为 计算 机 软件 .文件 是 计算 机 软件 中 不 可 缺少 的 组 成 部 分 , 它 的 作用 是 : 

a. 作为 开发 人 员 在 一 定 阶段 内 的 工作 成 果 和 结束 标志 ， 

b. 向 管理 人 员 提 供 软 件 开发 过 程 中 的 进展 和 情况 ,把 软件 开发 过 程 中 的 一 些 “ 不 可 见 的 ”事物 转 
换 成 “可 见 的 ”文字 资料 。 以 便 管 理 人 员 在 各 个 阶段 检查 开发 计划 的 实施 进展 ， 使 之 能 够 判断 原 定 目 标 是 
否 巳 达到 ,还 将 继续 耗 用 资源 的 种 类 和 数量 ， : 

c. ”记录 开发 过 程 中 的 技术 信息 ,便于 协调 以 后 的 软件 开发 .使 用 和 修改 ， 

d. 提供 对 软件 的 有 关 运 行 .维护 和 培训 的 信息 ,便于 管理 人 员 、 开 发 人 员 .操作 人 员 和 用 户 之 间 相 
互 了 解 彼此 的 工作 ， z 

e. 向 潜在 用 户 报导 软件 的 功能 和 性 能 ,使 他 们 能 判定 该 软件 能 否 服务 于 自己 的 需要 。 

换言之 ,本 指南 认为 :文件 的 编制 必须 适应 计算 机 软件 整个 生存 周期 的 需要 。. 

计算 机 软件 所 包含 的 文件 有 两 类 :一 类 是 开发 过 程 中 填写 的 各 种 图 表 , 可 称 之 为 工作 表格 ; 另 一 类 
则 是 应 编制 的 技术 资料 或 技术 管理 资料 ,可 称 之 为 文件 .本 指南 规定 软件 文件 的 编制 形式 ,并 提供 对 这 
些 规定 的 解释 。 本 指南 的 目的 是 使 得 所 编制 的 软件 文件 确实 能 够 起 到 软件 文件 应 该 发 挥 的 作用 . 


2 范围 


本 指南 是 一 份 指导 性 文件 .本 指南 建议 ,在 一 项 计算 机 软件 的 开发 过 程 中 ,一 般 地 说 ,应 该 产生 十 四 
种 文件 .这 十 四 种 文件 是 : 

可 行 性 研究 报告 ; 

项 目 开发 计划 ， 

软件 需求 说 明 书 ， 

数据 要 求 说 明 书 ; 

概要 设计 说 明 书 ; 

详细 设计 说 明 书 ; 

数据 库 设 计 说 明 书 ; 

用 户 手 册 ; z 
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.操作 手册 ， 

模块 开发 卷宗 ，; 

测试 计划 ， 

测试 分 析 报 告 ; 

开发 进度 月 报 ; 

项 目 开发 总 结 报告 。 

本 指南 将 给 出 开发 过 程 中 建议 产生 的 这 十 四 种 文件 的 编制 指导 ,同时 ,本 指南 也 是 这 十 四 种 文件 的 
编写 质量 的 检验 准则 .但 是 ,本 指南 并 未 涉及 软件 开发 过 程 中 如 何 填写 工作 表格 的 问题 。 

一 般 地 说 ,一 个 软件 总 是 一 个 计算 机 系统 (包括 硬件 .固件 和 软件 ) 的 组 成 部 分 。 鉴 于 计算 机 系统 的 

”多样 性 ,本 指南 一 般 不 涉及 整个 系统 开发 中 的 文件 编制 问题 ,本 指南 仅仅 是 软件 开发 过 程 中 的 文件 编制 

指南 。 


3 .文件 的 使 用 者 


管理 人 员 ， 可 行 性 研究 报告 
项 目 开发 计划 ， 
模块 开发 卷宗 ， 
开发 进度 月 报 ， 
项 目 开发 总 结 报告 } 
开发 人 员 : 可 行 性 研究 报告 ， 

z 项 目 开 发 计划 ， 
软件 需求 说 明 书 ， 
数据 要 求 说 明 书 ， 
概要 设计 说 明 书 ， 
详细 设计 说 明 书 ， 
数据 库 设计 说 明 书 ， 
测试 计划 ， 
测试 分 析 报 告 ; 

维护 人 员 :设计 说 明 书 ， 
测试 分 析 报告 ， 
模块 开发 卷宗 ; 
用 户 ;用 户 手册 ， 
操作 手册 。 \ 
尽管 本 指南 提出 了 在 软件 开发 中 文件 编制 的 要 求 ,但 并 不 意味 着 这 些 文件 都 必 须 交 给 用 户 。 一 项 软 
| 件 的 用 户 应 该 得 到 的 文件 的 种 类 由 供应 者 与 用 户 之 间 签 订 的 合同 规定 ， 


第 一 篇 文件 的 编制 指导 


4 ”软件 生存 周期 与 各 种 文件 的 编制 


一 项 计算 机 软件 ,从 出 现 一 个 构思 之 日 起 ,经 过 这 项 软件 开发 成 功 投 入 使 用 ,直到 最 后 决定 停止 使 


用 ,并 被 另 一 项 软件 代 蔡 之 时 止 , 被 认为 是 该 软件 的 一 个 生存 周期 。 一 般 地 说 这 个 软件 生存 周期 可 以 分 
十 LI 下 六 个 阶 马 . 
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可 行 性 与 计划 研究 阶段 

需求 分 析 阶 段 

设计 阶段 

实现 阶段 

测试 阶段 

运行 与 维护 阶段 
在 可 行 性 研究 与 计划 阶段 内 ,要 确定 该 软件 的 开发 目标 和 总 的 要 求 , 要 进行 可 行 性 分 析 、 投 资 -收益 
分 析 、 制 订 开发 计划 ,并 完成 应 编制 的 文件 。 

在 需求 分 析 阶 段 内 ,由 系统 分 析 人 员 对 被 设计 的 系统 进行 系统 分 析 , 确 定 对 该 软件 的 各 项 功能 .性 
能 需求 和 设计 约束 ,确定 对 文件 编制 的 要 求 ,作为 本 阶段 工作 的 结果 ,一 般 地 说 ,软件 需求 说 明 书 .数据 
要 求 说 明 书 和 初步 的 用 户 手册 应 该 编写 出 来 。 

在 设计 阶段 内 ,系统 设计 人 员 和 程序 设计 人 员 应 该 在 反复 理解 软件 需求 的 基础 上 ,提出 多 个 设计 ， 
分 析 每 个 设计 能 履行 的 功能 并 进行 相互 比较 ,最 后 确定 一 个 设计 ,包括 该 软件 的 结构 ,模块 的 划分 . 功 锡 
的 分 配 以 及 处 理 流 程 。 在 被 设计 系统 比较 复杂 的 情况 下 ,设计 阶段 应 分 解 成 概要 设计 阶段 和 详细 设计 阶 
段 两 个 步骤 。 在 一 般 情况 下 ,应 完成 的 文件 包括 :概要 设计 说 明 书 .详细 设计 说 明 书 和 测试 计划 初稿 。 

在 实现 阶段 内 ,要 完成 源 程序 的 编码 .编译 (或 汇编 ) 和 排 错 调试 得 到 无 语法 错 的 程序 清单 ,要 开始 
编写 模块 开发 卷宗 ,并 且 要 完成 用 户 手册 ,操作 手册 等 面向 用 户 的 文件 的 编写 工作 ,还 要 完成 测试 计划 
的 编制 。 

在 测试 阶段 ,该 程序 将 被 全 面 地 测试 ,已 编制 的 文件 将 被 检查 审阅 .一 般 要 完成 模块 开发 卷宗 和 测 
试 分 析 报告 ,作为 开发 工作 的 结束 ,所 生产 的 程序 .文件 以 及 开发 工作 本 身 将 逐 项 被 评价 ,最 后 写 出 项 目 
开发 总 结 报告 。 

在 整个 开发 过 程 中 ( 即 前 五 个 阶段 中 ), 开 发 集体 要 按 月 编写 开发 进度 月 报 。 

在 运行 和 维护 阶段 ,软件 将 在 运行 使 用 中 不 断 地 被 维护 ,根据 新 提出 的 需求 进行 必要 而 且 可 能 的 扩 
充 和 删改 。 

对 于 一 项 软件 而 言 ,其 生存 局 期 各 阶段 与 各 种 文件 编写 工作 的 关系 可 见 表 1, 其 中 有 些 文件 的 编写 
工作 可 能 要 在 若干 个 阶段 中 延续 进行 。 

表 1 软件 生存 周期 各 阶段 中 的 文件 编制 





| 

件 与 计划 阶段 析 阶 段 | 阶段 阶段 护 阶 段 

ne | 
mm 
wm | FH | | 
A | 
wom | | FH | 
mm | | | | | 
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续 表 1 
阶 段 可 行 性 研究 ， 需求 分 设计 运行 与 维 
件 与 计划 阶段 析 阶 段 | 阶段 护 阶段 


orn 1 
wm | | | 
we | 
“me | | 

， | 
测试 分 析 报 告 


开发 进度 月 报 


项 目 开发 总 结 


5 文件 编制 中 的 考虑 因素 


”文件 编制 是 一 个 不 断 努力 的 工作 过 程 。 是 一 个 从 形成 最 初 轮廓 ,经 反复 检查 和 修改 ,直到 程序 和 文 
件 正式 交付 使 用 的 完整 过 程 .其 中 每 一 步 都 要 求 工作 人 员 做 出 很 大 努力 。 要 保证 文件 编制 的 质量 ,要 体 
各 每 个 开 发 顶 目的 特点 也 要 注意 不 要 花 太 多 的 人 力 .为 此 ,编制 中 要 考虑 如 下 各 项 因素 。 
文件 的 读者 

种 文件 都 具有 特定 的 读者 .这 些 读者 包括 个 人 或 小 组 .软件 开发 单位 的 成 员 或 社会 上 的 公众 、- 

从 事 软件 工作 的 技术 人 员 、 管 理 人 员 或 领导 干部 .他 们 期 待 着 使 用 这 些 文件 的 内 容 来 进行 工作 ,例如 设 
” 计 , 编 写 程序 ,测试 .使 用 .维护 或 进行 计划 管理 ,因此 ， 这 些 文件 的 作者 必须 了 解 己 的 读者 ,这 些 文件 
的 编写 必须 注意 适应 自己 的 特定 读者 的 水 平 .特点 和 要 求 。 
5.2 重复 性 

: 本 指南 第 二 入 中 将 列 出 的 这 十 四 种 文件 的 内 容 要 求 中 ,显然 存在 菜 些 重复 . 较 明显 的 重复 有 两 类 。 
引言 是 每 一 种 文件 都 要 包含 的 内 容 ,以 向 读者 提供 总 的 梗概 .第 二 类 明显 的 重复 是 各 种 文件 中 的 说 明 部 
分 ,如 对 功能 性 能 的 说 明 、 对 输入 和 输出 的 描述 、 系 统 中 包含 的 设备 等 .这 是 为 了 方便 每 种 文件 各 自 的 读 
者 ,每 种 产品 文件 应 该 自 成 体系 ,尽量 避免 读 一 种 文件 时 又 不 得 不 去 参考 另 一 种 文件 .当然 ,在 每 一 种 广 


。 件 里 ,有 关 引 言 .说 明 等 同 其 他 文件 相 重复 的 部 分 ,在 行文 上 ,在 所 用 的 术语 上 、 在 详细 的 程度 上 ,还 是 应 


该 有 一 些 差别 ,以 适应 各 种 文件 的 不 同 读者 的 需要 。 

5.3 灵活 性 
鉴于 软件 开发 是 具有 创造 性 的 脑力 劳动 ， 秘 于 不 同 娄 伯 在 坑 术 上 和 和 复杂 和 区 上 六 出 大 ， 本 指南 

认为 在 文件 编制 工作 中 应 允许 一 定 的 灵活 性 。 这 种 灵活 性 表现 在 如 下 各 款 。 

5. 3.1 应 编制 的 文件 种 类 

尽管 本 指南 认为 在 一 般 情况 下 ,一 项 软件 的 开发 过 程 中 ,应 应 产生 的 文件 有 十 四 种 ， 然而 针对 一 项 具 

体 的 软件 开发 项 目 ， 有 时 不 必 编 制 这 么 多 的 文件 可 以 把 几 种 文件 合并 成 一 种 ,一 般 地 说 , 当 项 目的 规 
模 、 复 杂 性 和 成 败 风 险 增 大 时 ,文件 编制 的 范围 、 管理 手续 和 详细 程度 将 随 之 增加 。 反之 ， 则 可 适当 减少 。 
为 了 恰当 地 掌握 这 种 灵活 性 ， 本 指南 要 求人 贯彻 分 工 负责 的 原则 ,这 意味 着 : z 
z a. 一 个 软件 开发 单位 的 领导 机 构 应 该 根据 本 单位 经 营 承包 的 应 用 软件 的 专业 领域 和 本 单位 的 管 
理 能 力 ,制定 一 个 对 文件 编制 要 求 的 实施 规定 ， 主要 是 :在 不 同 的 条 件 下 ,应 该 形成 哪些 文件 ?这 些 文件 
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的 详细 程度 ?该 开发 单位 的 每 一 个 项 目 负责 人 ， 必须 认真 执行 这 个 实施 规定 。 这 种 规定 的 两 个 例子 可 见 
本 指南 的 附录 0( 参 考 件 ); 
b. 对 于 一 个 具体 的 应 用 软件 项 目 ， 项 目 负责 人 应 恨 据 上 述 实施 规定 ， 确定 一 个 文件 编制 计划 ,其 
中 包括 : 
(1) 应 该 编制 哪 几 种 文件 ,详细 程度 如 何 ? 
(z) 各 个 文件 的 编制 负责 人 和 进度 要 求 
(3) 审查 .批准 的 负责 人 和 时 间 进 度 安排 ; 
(4) 在 开发 时 期 内 ,各 文件 的 维护 .修改 和 管理 的 负责 人 ， 以 及 批准 手续 。 
每 项 工作 必须 落实 到 人 。 
这 个 文件 编制 计划 是 整个 开发 计划 的 重要 组 成 部 分 ， 
c. 有 关 的 设计 人 员 则 必须 严格 执行 这 个 文件 编制 计划 。 
5. 3.2 文件 的 详细 程度 
从 同一 份 提纲 起 草 的 文件 的 篇 幅 大 小 往往 不 同 ,可 以 少 到 几 页 ,也 可 以 长 达 几 百 页 ,对 于 这 种 差别 ， 
本 指南 是 允许 的 .此 详细 程度 取决 于 任务 的 规模 、 复杂 性 和 项 目 负责 人 对 该 软件 的 开发 过 程 及 运行 环境 
所 需要 的 详细 程度 的 判断 。 
5. 3.3 文件 的 扩展 
当 被 开发 系统 的 规模 非常 大 (例如 源码 超过 一 百 万 行 ) 时 ,一 种 文件 可 以 分 成 几 卷 编写 ,可 以 按 其 中 
每 一 个 系统 分 别 编制 ,也 可 以 按 内 容 划 分 成 多 卷 , 例 如 : 
项 目 开 发 计划 可 能 包括 :质量 保证 计划 ， 
配置 管理 计划 ， 
用 户 培 训 计 划 ， 
安装 实施 计划 ， 
系统 设计 说 明 书 可 分 写成 :系统 设计 说 明 书 ， 
子 系统 设计 说 明 书 ; 
程序 设计 说 明 书 可 分 写成 :程序 设计 说 明 书 ， 
接口 设计 说 明 书 ， 
版 本 说 明 ， 
操作 手册 可 分 写成 :操作 手册 ， 
安装 实施 过 程 ， 
测试 计划 可 分 写成 :测试 计划 ， 
测试 设计 说 明 ， 
测试 规程 ， 
测试 用 例 ; 
测试 分 析 报告 可 分 写成 :综合 测试 报告 ， 
验收 测试 报告 
项 目 开发 总 结 报告 亦 可 分 写成 项 目 开 发 总 结 报告 和 资源 环境 统计 。 
5.3.4 节 的 扩张 与 缩 并 
在 有 些 文件 中 ,5 可 以 使 用 本 指南 所 提供 的 章 .条 标题 ,但 在 条 内 又 存在 一 系列 需要 分 别 讨论 的 因素 ， 
本 指南 认为 ,所 有 的 条 都 可 以 扩展 ,可 以 进一步 细 分 ,以 适应 实际 需要 。 反 之 ， 如 果 章 条 中 的 有 些 细节 并 
非 必需 ,也 可 以 根据 实际 情况 缩 并 。 此 时 章 条 的 编号 应 相应 地 改变 
5. 3.5 程序 设计 的 表现 形式 
本 指南 对 于 程序 的 设计 表现 形式 并 未 作出 规定 或 限 侧 , 可 以 使 用 流程 图 的 形式 、 判定 表 的 形式 ,也 
可 以 使 用 其 他 表现 形式 ,如 程序 设计 语言 (PDL)、 问 题 分 析 图 (PAD) 等 。 : 
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5. 3.6 文件 的 表现 形式 
本 指南 对 于 文件 的 表现 形式 亦 未 作出 规定 或 限制 , 可 以 使 用 自然 语言 ' 也 可 以 使 用 形式 化 语言 。 
5. 3.7 文件 的 其 他 种 类 
当 本 指南 中 规定 的 文件 种 类 尚 不 能 满足 某 些 应 用 部 门 的 特殊 需要 时 ,他 们 可 以 建立 一 些 特殊 的 文 
件 种 类 要 求 ， 例如 软件 质量 保证 计划 、 软件 配置 管理 计划 等 ,这 些 要求 可 以 包含 在 本 单位 的 文件 编制 实 
施 规 定 中 。 


6 文件 编制 的 管理 工作 


文件 编制 工作 必须 有 管理 工作 的 配合 ,才能 使 所 编制 的 文件 真正 发 挥 它 的 作用 .文件 的 编制 工作 实 
际 上 贯穿 于 一 项 软件 的 整个 开发 过 程 ,因此 ,对 文件 的 管理 必须 贯穿 于 整个 开发 过 程 。 在 开发 过 程 中 必 
须 进 行 的 管理 工作 是 以 下 四 条 。 

6.1 文件 的 形成 

开发 集体 中 的 每 个 成 员 ,尤其 是 项 目 负责 人 ,应 该 认识 到 :文件 是 软件 产品 的 必 不 可 少 的 组 成 部 分 ; 
在 软件 开发 过 程 的 各 个 阶段 中 ,必须 按照 规定 及 时 地 完成 各 种 产品 文件 的 编写 工作 ;必须 把 在 一 个 开发 
步骤 中 作出 的 决定 和 取得 的 结果 及 时 地 写 入 文件 ;开发 集体 必须 及 时 地 对 这 些 文件 进行 严格 的 评审 ;这 
些 文件 的 形成 是 各 个 阶段 开发 工作 正式 完成 的 标志 。 这 些 文件 上 必须 有 编写 者 .评审 者 和 批准 者 的 签 
字 ,必须 有 编写 .评审 完成 的 日 期 和 批准 的 日 期 。 

6.2 锭 件 的 分 类 与 标识 

在 软件 开发 的 过 程 中 ,产生 的 文件 是 很 多 的 ,为 了 便于 保存 .查找 、 使 用 和 修改 ， 应 该 对 文件 按 层 次 
地 加 以 分 类 组 织 , 一 个 软件 开发 单位 应 该 建立 一 个 对 本 单位 文件 的 标识 方法 ,使 文件 的 每 一 页 都 具有 胃 
确 的 标识 。 例如 可 以 按 如 下 四 个 层次 对 文件 加 以 分 类 和 标识 。 

a. 文件 所 属 的 项 目的 标识 ; 

b. 文件 种 类 的 标识 ; 

c. ”同一 种 文件 的 不 同 版 本 号 ， 

d. 页 号 。 

此 外 ， 对 每 种 文件 还 应 根据 顶 目的 性 质 , 划 定 它们 各 自 的 保密 级 别 ,确定 他 们 各 自 的 发 行 范围 
”6.5 文件 的 控制 

”在 一 项 软件 的 开发 过 程 中 ， 随 着 程序 的 逐步 形成 和 逐步 修改 ， 各 种 文件 亦 在 不 断 地 产生 .不 断 地 修 
改 或 补充 .因此 ,必须 加 以 周密 的 控制 ,以 保持 文件 与 程序 产品 的 一 致 性 ,保持 各 种 文件 之 间 的 一 至 性 和 
文件 的 安全 性 。 这 种 控制 表现 为 : 

a. 就 从 事 一 项 软件 开发 工作 的 开发 集体 而 言 ,应 设置 一 位 专职 的 文件 管理 人 员 ( 接 口 管理 工程 师 
或 文件 管理 员 ) ;在 开发 集体 中 ,应 该 集中 保管 本 项 目 现 有 全 部 文件 的 主 文本 两 套 , 由 该 文件 管理 人 员 负 
责 保 管 ; 

b. 每 一 份 提交 给 文件 管理 人 员 的 文件 都 必须 具有 编写 人 ,审核 人 和 批准 人 的 签字 ; 

ce. 这 两 套 主 文本 的 内 容 必须 完全 一 致 ;其 中 有 一 套 是 可 供出 借 的 , 另 一 套 是 绝对 不 能 出 借 的 ,以 
免 发 生 万 一 ;可 出 借 的 主 文本 在 出 借 时 必须 办 理 出 借 手 续 , 归 还 时 办 理 注销 出 借 手续 ;， 

d. ”开发 集体 中 的 工作 人 员 可 以 根据 工作 的 需要 ,在 本 项 目的 开发 过 程 中 持 有 一 些 文件 , 即 所 谓 个 
人 文件 ,包括 为 使 他 完成 他 承担 的 任务 所 需要 的 文件 ,以 及 他 在 完成 任务 过 程 中 所 编制 的 文件 ;但 这 种 
个 人 文件 必须 是 主 文本 的 复制 品 , 必 须 同 主 文本 完全 一 致 ,车 要 修改 ,必须 首先 修改 主 文本 ; 

e. 不 同 开发 人 员 所 拥有 的 个 人 文件 通常 是 主 文本 的 各 种 子 集 ;所 谓 子 集 是 指 把 主 文本 的 各 个 部 
分 根据 承担 不 同 任务 的 人 员 或 部 门 的 工作 需要 加 以 复制 .组 装 而 成 的 若干 个 文件 的 集合 ;文件 管理 人 员 
应 该 列 出 一 份 不 同 子 集 的 分 发 对 象 的 清单 ,按照 清单 及 时 把 文件 分 发 给 有 关 人 员 或 部 门 ; 

f. 一 份 文件 如 果 已 经 被 另 一 份 新 的 文件 所 代替 , 则 原文 件 应 该 被 注销 ;文件 管理 人 中 要 随时 整理 
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主 文本 ,及 时 反映 出 文件 的 变化 和 增加 情况 ,及 时 分 发 文件 ; 

g. 当 一 个 项 目的 开发 工作 临近 结束 时 ,文件 管理 人 员 应 逐个 收回 开发 集体 内 每 个 成 员 的 个 人 文 
件 , 并 检查 这 些 个 人 文件 的 内 容 ; 经 验 表 明 ,这 些 个 人 文件 往往 可 能 比 主 文本 更 详细 ,或 同 主 文本 的 内 容 
有 所 不 同 ,必须 认真 监督 有 关 人 员 进 行 修改 ,使 主 文本 能 真正 反映 实际 的 开发 结果 。 

6.4 文件 的 修改 管理 

在 一 个 项 目的 开发 过 程 中 的 任何 时 刻 ， 开发 集体 内 的 所 有 成 员 都 可 能 对 开发 工作 的 已 有 成 果 一 一 
文件 ,提出 进行 修改 的 要 求 , 提 出 修改 要 求 的 理由 可 能 是 各 种 各 样 的 ,进行 修改 而 引起 的 影响 可 能 很 小 ， 
也 可 能 会 牵涉 到 本 项 目的 很 多 方面 .因此 ,修改 活动 的 进行 必须 谨慎 ,必须 对 修改 活动 的 进行 加 以 管理 ， 
必须 执行 修改 活动 的 规程 ,使 整个 修改 活动 有 控制 地 进行 。 

修改 活动 可 分 如 下 五 个 步骤 进行 : 

a. 提议 ”开发 集体 中 的 任何 一 个 成 员 都 可 以 向 项 目 负责 人 提出 修改 建议 ,为 此 应 该 填写 一 份 修 
改建 议 表 ,说 明 修改 的 内 容 、 所 修改 的 文件 和 部 位 、 以 及 修改 理由 ， : 

b.、 评议 由 项 目 负责 人 或 项 目 负责 人 指定 的 人 员 对 该 修改 建议 进行 评议 ,包括 审查 该 项 修改 的 
必要 性 .确定 这 一 修改 的 影响 范围 .研究 进行 修改 的 方法 ,步骤 和 实施 计划 
”ec。 审核 一 般 由 项 目 负 责 人 进行 审核 ,包括 核实 修改 的 目的 和 要 求 、 核 实 修改 活动 将 带 来 的 影 
响 、 审 核 修改 活动 计划 是 否 可 行 ; 

d. 批准 ”在 一 般 情况 下 ,批准 权 属 于 该 开发 单位 的 部 门 负责 人 ;在 批准 时 ,主要 是 决断 修改 工作 
中 各 项 活动 的 先后 顺序 及 各 自 的 完成 日 期 ,以 保证 整个 开发 工作 按 原 定 计划 日 期 完成 ， 

e. 实施 ”由 项 目 负责 人 按照 已 批准 的 修改 活动 计划 ,安排 各 项 修改 活动 的 负责 人 员 进 行 修改 , 建 
立 修 改 记录 .产生 新 的 文件 以 取代 原 有 文件 .最 后 把 文件 交 文 件 管理 人 员 归 档 ,并 分 发 给 有 关 的 持 有 者 。 


第 二 篇 ”各 种 文件 的 内 容 要 求 


本 篇 将 对 引言 中 提 到 的 十 四 种 文件 提供 内 容 要 求 , 作 为 文件 编制 的 技术 标准 。 
7 可 行 性 研究 报告 


可 行 性 研究 报告 的 编写 目的 是 ;说 明 该 软件 开发 项 目的 实现 在 技术 经济 和 社会 条 件 方面 的 可 行 
性 ， 评述 为 了 合理 地 达到 开发 目标 而 可 能 选择 的 各 种 方案 ;说 明 并 论证 所 选 定 的 方案 。 
可 行 性 研究 报告 的 编写 内 容 要 求 如 下 : 
1 引言 
1.1 编写 目的 
1.2 背景 
1.3 定义 
1.4 参考 资料 
2 可 行 性 研究 的 前 提 
2.1 要 求 
.2.2 目标 
.2.5 条件, 假定 和 限制 
2.4 进行 可 行 性 研究 的 方法 
2.5 评价 尺度 
5 对 现 有 系统 的 分 析 
3.] 数据 流程 和 处 理 流程 
3.2 工作 负荷 
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7. 3.3 费用 开支 
7.3.4 人 员 

7. 3.5 设备 

7.3.6 局 限 性 

7.4 所 建议 的 系统 

7. 4.1 对 所 建议 系统 的 说 明 
7.4.2 数据 流程 和 处 理 流 程 
7. 4.3 改进 之 处 

7.4.4 影响 

7. 4.4.1 对 设备 的 影响 
7. 4. 4. 2 ”对 软件 的 影响 
7.4.4.5 对 用 户 单位 机 构 的 影响 
7. 4. 4. 4 对 系统 运行 的 影响 
7. 4.4.5 对 开发 的 影响 

7. 4.4.6 对 地 点 和 设施 的 影响 
7. 4, 4.7 对 经 费 开支 的 影响 
7. 4.5 局 限 性 

7. 4.6 技术 条 件 方面 的 可 行 性 
7.5 可 选择 的 其 他 系统 方案 
7.5.1 可 选择 的 系统 方案 1 
.7.5.2 可 选择 的 系统 方案 2 


本 和 寺中 咎 


投资 及 收益 分 析 

1 支出 

.1.1 基本 建设 投资 
1.2 ”其 他 一 次 性 支出 
1.3 非 一 次 性 支出 
2 收益 

2.1 一 次 性 收益 
.2.2 非 一 次 性 收益 
6,2.3 不 可 定量 的 收益 
6.3 收益 /投资 比 

6.4 ”投资 回收 周期 
.6.5 敏感 性 分 析 

7.7 社会 条 件 方 面 的 可 行 性 
.7.7.1 法律 方面 的 可 行 性 
7.7.2 使 用 方面 的 可 行 性 
7.8 结论 


8 项 上 开发 计划 


编制 项 目 开发 计划 的 目的 是 用 文件 的 形式 ,把 对 于 在 开发 过 程 中 各 项 工作 的 负责 人 员 开发 进度 、 
。 所 需 经 费 预算 ,所 需 软 、 硬 件 条 件 等 问题 作出 的 安排 记载 下 来 ,以 便 根据 本 计划 开展 和 检查 本 项 目的 于 
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”发 工作 .编制 内 容 要 求 如 下 ， 
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1 引 吉 

1.1 .编写 目的 
1.2 背景 
1.3 定义 
1.4 参考 资料 
2 项 目 概述 
2.1 工作 内 容 

2.2 主要 参加 人 员 

2.3 产品 及 成 果 

2. 3.1 程序 

2. 53,2 文件 

2.3.3 服务 

2. 3.4 非 移 交 产 品 

2.4 验收 标准 

2.5 完成 项 目的 最 迟 期 限 
2.6 本 计划 的 审查 者 与 批准 者 
35 实施 总 计划 

3.1 工作 任务 的 分 解 _ 

3 接口 人 员 

3.3 进度 

3.4 预算 

3 
4 
4 
4. 
4， 
5 


省 
on 和 CN fo 一 


75 关键 问题 

支持 条 件 

.1 计算 机 系统 支持 

2 需要 用 户 承 担 的 工作 
5 需 由 外 单位 提供 的 条 件 
专题 计划 要 点 


9 软件 需求 说 明 书 


“mmm 


软件 需求 说 明 书 的 编制 是 为 了 使 用 户 和 软件 开发 者 双方 对 该 软件 的 初始 规定 有 一 -个 共同 的 理解 ， 
使 之 成 为 整个 开发 工作 的 基础 。 编制 软件 需求 说 明 书 的 内 容 要 求 如 下 : 
9.1 引言 
1.1 编写 目的 
1.2 背景 
1.3 定义 
1.4 参考 资料 
2 任务 概述 
.2.1 目标 
2.2 用 户 的 特点 
2.3 假定 与 约束 
3 需求 规定 
3.1 对 功能 的 规定 
3.2 对 性 能 的 规定 
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9. 3.2.1 精度 

9. 3.2.2 时 间 特 性 要 求 
9. 3.2.3 灵活 性 

9. 3.3 输入 输出 要 求 
9.3.4 数据 管理 能 力 要 求 
9. 3.5 故障 处 理 要 求 
9.3.6 其 他 专门 要 求 
3.4 运行 环境 规定 
9. 4.1 设备 

9. 4. 2 支持 软件 
9.4.3 接口 

9. 4.4 控制 


10 数据 要 求 说 明 书 


数据 要 求 说 明 书 的 编制 目的 是 为 了 向 整个 开发 时 期 提供 关于 被 处 理 数据 的 描述 和 数据 采集 要 求 的 
: 技术 信息 .编制 数据 要 求 说 明 书 的 内 容 要 求 如 下 : 


10.1 引言 

10.1.1 编写 目的 
10. 1.2 背景 

10.1.3 定义 

10.1.4 参考 资料 
10.2 ”数据 的 逻辑 描述 
10.2.1 静态 数据 
10.2.2 动态 输入 数据 
10. 2.5 动态 输出 数据 
10.2.4 内 部 生成 数据 
10.2.5 数据 约定 
10.5 数据 的 采集 


10. 5.1 要 求 和 范围 _ 
10.3.2 输入 的 承担 者 
10.3.3 处 理 
10.3.4 影响 


11 概要 设计 说 明 书 


概要 设计 说 明 书 又 可 称 系统 设计 说 明 书 ,这 里 所 说 的 系统 是 指 程序 系统 。 编 制 的 目的 是 说 明 对 程序 
”系统 的 设计 考虑 ,包括 程序 系统 的 基本 处 理 流程 .程序 系统 的 组 织 结构 .模块 划分 .功能 分 配 .接口 设计 、 
运行 设计 ,数据 结构 设计 和 出 错 处 理 设计 等 ,为 程序 的 详细 设计 提供 基础 .编制 概要 设计 说 明 书 的 内 容 
要 求 如 下 ， 

11.1 引言 

11.1.1 编写 目的 

11.1.2 背景 

11.1.3 定义 

11.1.4 参考 资料 
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11.2 总 体 设 计 

11.2.1 需求 规定 

11. 2.2 运行 环境 

11.2.3 基本 设计 概念 和 处 理 流 程 
11. 2. 4 ”结构 

11.2.5 功能 需求 与 程序 的 关系 
11.2.6 人工 处 理 过 程 

11. 2.7 尚未 解决 的 问题 

11.3 接口 设计 

11.3.1 用 户 接 口 . 

11. 3.2 外 部 接口 

11.3.3 内 部 接口 

11.4 运行 设计 

11.4.1 运行 模块 组 合 

11. 4.2 ”运行 控制 

11. 4.5 运行 时 间 

11.5 系统 数据 结构 设计 

11. 5.1 逻辑 结构 设计 要 点 
11.5.2 物理 结构 设计 要 点 
11.5.3 数据 结构 与 程序 的 关系 


11.6 系统 出 错 处 理 设计 
11.6.1 出 错 信息 - 
11.6.2 补救 措施 
11.6.3 系统 维护 设计 


12 详细 设计 说 明 书 z 
详细 设计 说 明 书 又 可 称 程序 设计 说 明 书 .编制 目的 是 说 明 一 个 软件 系统 各 个 层次 中 的 每 一 个 程序 


(每 个 模块 或 子 程序 ) 的 设计 考虑 ,如 果 一 个 软件 系统 比较 简单 ,层次 很 少 ;本 文件 可 以 不 单独 编写 ,有 关 
内 容 合 并 入 概要 设计 说 明 书 ,对 详细 设计 说 明 书 的 内 容 要 求 如 下 ， : 


12.1 引言 

12.1.1 编写 目的 

12.1.2 背景 

12.1.3 定义 

12.1.4 参考 资料 

12.2 程序 系统 的 组 织 结构 
12.35 程序 1( 标 识 符 ) 设 计 说 明 
12. 3.1 程序 描述 

12. 3.2 功能 

12.3.3 性 能 

12.3.4 输入 项 

12.3.5 输出 项 . 

12. 5.6 算法 

12. 3.7 流程 迎 辑 


GB 8567— 88 





12. 3.8 接口 

12. 3.9 存储 分 配 

12. 3.10 注释 设计 

12. 3.11 限制 条 件 

12.3.12 测试 计划 
”12. 3.13 尚未 解决 的 问题 
“12.4 程序 2( 标 识 符 ) 设 计 说 明 


13 数据 库 设计 说 明 书 


数据 库 设计 说 明 书 的 编制 目的 是 对 于 设计 中 的 数据 库 的 所 有 标识 .四 辑 结 构 和 物理 结构 作出 具 休 
的 设计 规定 .其 内 容 要 求 如 下 : 
13.1 引证 

.1 编写 目的 

2 背景 

3 定义 

4 参考 资料 

外 部 设计 
标识 符 和 状态 
使 用 它 的 程序 
.约定 

专门 指导 

支持 软件 

结构 设计 
.5.1 概念 结构 设计 
2 逻辑 结构 设计 

5 物理 结构 设计 

. 4， 运用 设计 

.1 数据 字典 设计 
15 4. 2 安全 保密 设计 


14 ”用 户 手册 


用 户 手 册 的 编制 是 要 使 用 非 专门 术语 的 语言 ,充分 地 描述 该 软件 系统 所 具有 的 功能 及 基本 的 使 用 
方法 。 使 用 户 ( 或 潜在 用 户 ) 通 过 本 手册 能 够 了 解 该 软件 的 用 逻 ， 并 且 能 够 确定 在 什么 情况 下 ， 如 何 使 用 
它 . 具 体 的 内 容 要 求 如 下 ，; 

14.1 引言 

.14.1.1 编写 日 的 

14.1.2 背景 

14.1.3 定义 z 

14.1.4 参考 资料 

14.2 用途 

”14.2.1 功能 
-14.2.2 性 能 


[2 -CN fb 歼 


1 
1 
二 
1. 
1. 
2 
2 
2 
2. 
13. 2， 
2 
3 
3 
3， 
5. 
4 
4 
4 
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14.2.2.1 精度 
14.2.2.2 时 间 特 性 

14.2.2.3 灵活 性 

14. 2.3 安全 保密 

14.3 运行 环境 

14. 3.1 看 设备 

14.5.2 支持 软件 

14.3.3 数据 结构 

14.4 使 用 过 程 

14. 4.1 安装 与 初始 化 
14.4.2 输入 | 
14. 4.2.1 输入 数据 的 现实 背景 
14. 4.2.2 输入 格式 
14.4.2.3 输入 举例 

14.4.3 输出 
14. 4. 5.1 输出 数据 的 现实 背景 
14. 4. 3.2 输出 格式 
14. 4. 3.3 输出 举例 

14. 4.4 文 卷 查询 

14. 4.5 出 错 处 理 与 恢复 

14. 4.6 终端 操作 

15 ”操作 手册 


操作 手册 的 编制 是 为 了 向 操作 人 员 提 供 该 软件 每 一 个 运行 的 具体 过 程 和 有 关 知识 ,包括 操作 方法 
的 细节 。 具 体 的 内 容 要 求 如 下 : 


15.1 引 喜 
“15.1.1 编写 目的 
15.1.2 背景 
15.1.3 定义 
15.1.4 参考 资料 
15.2 软件 概述 
.15.2.1 软件 的 结构 
15. 2.2 程序 表 
15. 2. 3 文 卷 表 
15.3 安装 与 初始 化 
15. 4 运行 说 明 
15. 4.1 运行 表 
15. 4.2 运行 步骤 
15.4.3 运行 1( 标 识 符 )? 说 明 
15. 4. 3.1 运行 控制 
15. 4. 3.2 操作 信息 


15. 4. 3.3 输入 -输出 文 卷 
15. 4. 3.4 输出 文 段 
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15. 4. 3. 5 输出 文 段 的 复制 
15. 4. 3.6 启动 恢复 过 程 
15.4.4 运行 2( 标 识 符 ) 说 明 
15.5 非常 规 过 程 

15.6 远程 操作 


16 ”模块 开发 卷宗 


模块 开发 卷宗 是 在 模块 开发 过 程 中 逐步 编写 出 来 的 ,每 完成 一 个 模块 或 一 组 密切 相关 的 模块 的 复 
审 时 编写 一 份 , 应 该 把 所 有 的 模块 开发 卷宗 汇集 在 一 起 ,编写 的 目的 是 记录 和 汇总 低层 次 开发 的 进度 和 
结果 ,以 便于 对 整个 模块 开发 工作 的 管理 和 复审 ,并 为 将 来 的 维护 提供 非常 有 用 的 技术 信息 。 具 体 的 内 
容 要 求 如 下 ， z : 
“16.1 标题 . 
16. 2 ”模块 开发 情况 表 ( 见 下 表 ) 
模块 开发 情况 表 


”模块 标识 答 : 加 
模块 的 描述 性 名 称 
计划 开始 日 期 
实际 开始 日 期 。 


六 
到 
演 
二 


计划 完成 日 其 


实际 完成 日 期 : 
计划 开始 日 期 


| 实际 开始 日 其 : 


落 
水 
页 


+ 


计划 完成 日 期 
实际 完成 日 期 
计划 开始 日 期 
实际 开始 日 其 


”组 装 测试 
计划 完成 日 期 


实际 完成 日 期 


代码 复查 日 期 /签字 


源 代码 行 数 


二 


将 | 吉 | 凋 | 沿 
忆 | 玫 | 可 | 六 


”目标 模块 大 小 
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昌 


16.5 功能 说 明 
16.4 设计 说 明 
16.5 源 代 码 清单 
16.6 测试 说 明 
16.7 ”复审 的 结论 


17 测试 计划 


”这 里 所 说 的 测试 ,主要 是 指 整个 程序 系统 的 组 装 测试 和 确认 测试 .本 文件 的 编制 是 为 了 提供 一 个 对 
该 软件 的 测试 计划 ,包括 对 每 项 测试 活动 的 内 容 、 进 度 安排 .设计 考 虚 、 测 试 数据 的 整理 方法 及 评价 准 
则 .具体 的 内 容 要 求 如 下 : 

17.1 引言 

17.1.1 编写 目的 

17.1.2 背景 

17.1.3 定义 

17.1.4 参考 资料 
计划 

1 软件 说 明 
2 测试 内 容 
5 测试 1( 标 识 符 ) 
.3.1 进度 安排 
.5.2 条件 
:3.3 测试 资料 
. 3.4 测试 培训 
4 测试 2( 标 识 符 ) 
测试 设计 说 明 
1 测试 1( 标 识 符 ) 
1.1 控制 
1.2 输入 
1.3 输出 
1.4 过 程 
2 测试 2( 标 识 符 ) 


] 
] 
1 
] 
2 
2 
2 
17.2. 
2 
2 
2 
2 
2 


m= 
各 LJ 三 1 者 
Wmmma 


4 评价 准则 
17.4.1 范围 
.4.2 数据 整理 
17.4.35 尺度 


18 测试 分 析 报告 
测试 分 析 报 告 的 编写 是 为 了 把 组 装 测试 和 确认 测试 的 结果 发现 及 分 析 写成 文件 加 以 记载 ,具体 的 
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编写 内 容 要 求 如 下 ; 
18.1 引言 
18.1.1 编写 目的 
2 背景 
.3 定义 
.4 参考 资料 
测试 概要 
测试 结果 及 发 现 
1 测试 1( 标 识 符 ) 
.2 测试 2( 标 识 符 ) 
4 对 软件 功能 的 结论 
4.1 功能 1( 标 识 符 ) 
18. 4.1.1 能 力 
4 
4 


dh 
CO 0 WO 0 GD 6 
CM CN EN 和 3 OO 


.4.1.2 限制 
.4.2 功能 2( 标 识 符 ) 


18.5.4 评价 
18.6 测试 资源 消耗 


19 开发 进度 月 报 


开发 进度 月 报 的 编制 目的 是 及 时 向 有 关 管 理 部 门 汇报 项 目 开发 的 进展 和 情况 ,以 便 及 时 发 现 和 处 
理 开 发 过 程 中 出 现 的 问题 。 一 般 地 ,开发 进度 月 报 是 以 项 目 组 为 单位 每 月 编写 的 。 如 果 被 开发 的 软件 系 
统 规 模 比较 大 ,整个 工程 项 目 被 划分 给 若干 个 分 项 目 组 承担 ,开发 进度 月 报 将 以 分 项 目 组 为 单位 按 月 纺 
19.1 标题 
19.2 工程 进度 与 状态 
1 进度 
.2 状态 
资源 耗 用 与 状态 
1 资源 耗 用 
.1.1 工时 
.1.2 机 时 
.2 状态 z 
经 费 支出 与 状态 
1 经 费 支 出 
.1.1 支持 性 费用 
.1.2 设备 购置 费 
.2 状态 


ae 
血 四 而 要 扑 的 Es 站 汪 的 和 四 
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19.5 下 个 月 的 工作 计划 
19.6 建议 
20 项 目 开发 总 结 报告 


项 目 开 发 总 结 报告 的 编制 是 为 了 总 结 本 项 目 开发 工作 的 经 验 ， 说 明 实际 取得 的 开发 结果 以 及 对 整 
个 开发 工作 的 各 个 方面 的 评价 。 具体 的 内 容 要 求 如 下 


20.1 引 官 

` 20.1.1 编写 目的 

20.1.2 背景 

20.1.3 定义 

20. 1.4 参考 资料 

20. 2 实际 开发 结果 
”20.2.1 产品 

20.2.2 主要 功能 和 性 能 
20.2.3 基本 流程 
“20.2.4 进度 

20.2.5 费用 

20.3 开发 工作 评价 
”20.3.1 对 生产 效率 的 评价 
“20. 3.2 对 产品 质量 的 评价 
20. 3. 3 ”对 技术 方法 的 评价 
20. 3.4 出 错 原 因 的 分 析 
20.4 经 验 与 教训 


A.] 
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可 行 性 研究 报告 的 编写 提示 
(参考 件 ) | 


引言 


A,1.1 


编写 目的 


涪 明 编写 本 可 行 性 研究 报告 的 目的 ， 指出 预期 的 读者 
A.1.2 和 背景 
说 期 4 


b. 


所 建议 开发 的 软件 系统 的 名 称 ， 


本 项 目的 任务 提出 者 开发 者 ,用 户 及 实现 该 软件 的 计算 中 心 或 计算 机 网 络 ， 


“i “六 软 体系 统 同 其 他 系统 总 其 他 机 构 的 基本 的 丰 查 米 往 关 宁 。 
A.1.5 定义 

列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文 首 字母 组 词 的 原 词组 。 
A. 1.4 参考 资料 
” 列 明 用 得 着 的 参考 发 料 , 如 ; 


和 a， 


b. 


©， 


本 项 目的 经 核准 的 计划 任务 书 或 合同 、 上 级 机 关 的 批文 
局 闪 兴 项 里 的 其他 世 发 六 的 净 件 ; 有 : 
本 文件 中 各 处 引用 的 文件 .资料 ， 包括 所 需 用 到 的 软件 开发 标准 : 


网 出 送 些 区 伴 痪 料 的 标 荐 ,文件 编号 .发表 日 期 和 出 版 单 亿 , 说 明 能 够 得 到 这 些 文件 资料 的 来 源 。 
A.2 可 行 性 研究 的 前 提 | z 


说 明 对 所 建议 的 开发 项 目 进行 可 行 性 研究 的 前 提 , 如 要 求 .目标 、 假 定 .限制 等 。 
A& 
说 明 对 所 建议 开发 的 软件 的 基本 要 求 ,如 ， 


功能 ; 

性 能 ; 

输出 “如 报告 ,文件 或 数据 ,对 每 项 输出 要 说 明 其 特征 ,如 用 途 、 产 生 频 度 、 接口 以 及 分 发 对 象 
输入 ”说明 系统 的 输入 ,包括 数据 的 来 源 ,类 型 ,数量 .数据 的 组 红 以 及 提供 的 频 度 ， 

处 理 流程 和 数据 流程 用 图 表 的 方式 表示 出 最 基本 的 数据 流程 和 处 理 流程 ， 并 畏 之 以 级 述 ， 


:43 在 安全 与 保密 方 殴 的 要 求 


同 本 系统 相连 接 的 其 他 系 绕 ; 
完成 期 限 。 : 


A.2.2 目标 
说 明 所 建议 系统 的 主要 开发 目标 ,如 


人 力 与 设备 费用 的 减少 ; 


:处理 速 赔 的 担 葡 5 


控制 精度 或 生产 能 力 的 提高 ， 
管理 信息 服务 的 改进 ， 
自动 决策 系统 的 改进 

人 员 利 用 率 的 改进 。 
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A.2.3 条 件 、 假 定 和 限制 
说 明 对 这 项 开发 中 给 出 的 条 件 、 假定 和 所 受到 的 限制 ， 如 : 
所 建议 系统 的 运行 寿命 的 最 小 什 ;; 
进行 系统 方案 选择 比较 的 时 间 ; 
经 费 .投资 方面 的 来 源 和 限制 ; 
法 律 和 政策 方面 的 限制 ， 
硬件 ,软件 ,运行 环境 和 开发 环境 方面 的 条 件 和 限制， 
可 利用 的 信息 和 资源 ， 
8 系统 投入 使 用 的 最 晚 时 间 ，。 
A.2.4 进行 可 行 性 研究 的 方法 
说 明 这 项 可 行 性 研究 将 是 如 何 进行 的 ， 所 建议 的 系统 将 是 如 何 评价 的 ， 摘要 说 明 所 使 用 的 基本 方法 
和 策略 ,如 调查 、 加 权 、 确 定 模 型 .建立 基准 点 或 仿真 等 。 z 
A.2.5 评价 尺度 
说 明 对 系统 进行 评价 时 所 使 用 的 主要 凤 度 ， 如 费用 的 乞 少 、 各 项 功能 的 优先 次 序 开发 时 间 的 长 短 
及 使 用 中 的 难 易 程度 。 


A.3 对 现 有 系统 的 分 析 


这 里 的 现 有 系统 是 指 当前 实际 使 用 的 系统 ， 这 个 系统 可 能 是 计算 机 系统 ， 也 可 能 是 一 个 机 械 系 统 其 
至 是 一 个 人 工 系统 。 
分 析 现 有 系统 的 目的 是 为 了 进 一 -六 中 的 开 和 新 系 放 必 现 有 条 的 要 人 
A, 5,1 处 理 流程 和 数据 流程 
说 明 现 有 系统 的 基本 的 处 理 流程 和 数据 流程 。 此 流程 可 用 图 表 即 流程 图 的 形式 表示 ， 并 加 以 叙述 。 
A. 3.2 工作 负荷 
列 出 现 有 系统 所 承担 的 工作 及 工作 量 。 
”A. 35.3 费用 开支 
列 出 由 于 运行 现 有 系统 所 引起 的 费用 开支 ,如 入 力 、 设备 、 空间 ,支持 性 服务 .材料 等 项 开支 以 及 开 
支 总 额 。 
A.3.4 人 员 
列 出 为 了 现 有 系统 的 运行 和 维护 所 需要 的 人 员 的 专业 技术 类 别 和 数量 。 
A,35.5 设备 
。 列 出 现 有 系统 所 使 用 的 各 种 设备 。 
A.3.6 局 限 性 
列 出 本 系统 的 主要 的 局 限 性 ， 例如 处 理 时 间 赶 不 上 需要 ,响应 不 及 时 ,数据 存储 能 力 不 足 ,处 理 功能 
不 够 等 .并 且 要 说 明 ,为 什么 对 现 有 系统 的 改进 性 维护 已 经 不 能 解决 问题 ; 


A.4 所 建议 的 系统 


本 章 将 用 来 说 明 所 建议 系统 的 目标 和 要 求 将 如 何 被 满足 。 
A.4.1 对 所 建议 系统 的 说 明 
概括 地 说 明 所 建议 系统 ， 并 说 明 在 第 A. 2 章 中 列 出 的 那些 要 求 将 如 何 得 到 满足 ， 说 明 所 使 用 的 基本 
方法 及 理论 根据 。 
A. 4.2 处 理 流 程 和 数据 流程 
给 出 所 建议 系统 的 处 理 流 程 和 数据 流程 。 
“A.4.3 改进 之 处 
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” 按 A. 2. 2 条 中 列 出 的 自 标 , 逐 项 说 节 所 建议 系统 相对 于 现存 系统 具有 的 改进 。 
A.4.4 影响 
说 明 在 建立 所 建议 系统 时 ， 预期 将 带 来 的 影响 ， 包括 : 
A.4.4.1 对 设备 的 影响 
说 明 新 提出 的 设备 要 求 及 对 现存 系统 中 尚 可 使 用 的 设备 须 作出 的 修改 。 
A. 4. 4. 2 对 软件 的 影响 
”说明 为 了 使 现存 的 应 用 软件 和 支持 软件 能 够 同 所 建议 系统 相 适应 ; 而 需要 对 这 些 软 件 所 进行 的 修 
改 和 补充 。 z 
A. 4.4.3 对 用 户 单位 机 构 的 影响 
说 明 为 了 建立 和 运行 所 建议 系统 ,对 用 户 单位 机 构 、 人 员 的 数量 和 丢 术 水 二 等 方 面 的 全 许可 束 。 
A. 4. 4. 4 对 系统 运行 过 程 的 影响 
， 说 明 所 建议 系统 对 运行 过 程 的 影响 ,如 : 
z 用 户 的 据 作 规程 ， 
运行 中 心 的 操作 规程 ; 
运行 中 心 与 用 户 之 间 的 关系 ; 
源 数据 的 处 理 ， : 
数据 进入 系统 的 过 程 ， 
对 数据 保存 的 要 求 ,对 数据 存储 、 恢 复 的 处 理 ， 
输出 报告 的 处 理 过 程 、 存 储 媒 体 和 调度 方法 ; 
_h. 系统 失效 的 后 果 及 恢复 的 处 理 办 法 。 
A.4.4.5 对 开发 的 影响 
”说 明 对 开发 的 影响 ,如 : 
.ea 为 了 支持 所 建议 系统 的 开发 ， 用 户 需 进行 的 工作 ; 
b. 为 了 建立 一 个 数据 库 所 要 求 的 数据 资源 ; 
c. 为 了 开发 和 测验 所 建议 系统 而 需要 的 计算 机 资源 ; 
dd 所 涉及 的 保密 与 安全 问题 。 
A. 4.4.6 对 地 点 和 设施 的 影响 
说 明 对 建筑 物 改 造 的 要 求 及 对 环境 设施 的 要 求 。 
A. 4.4.7 对 经 费 开 支 的 影响 
扼要 说 明 为 了 所 建议 系统 的 开发 ， 设计 和 维持 运行 面 省 要 的 各 项 经 费 开支 。 
A. 4.5 局 限 性 
说 明 所 建议 系统 尚 存在 的 局 限 性 以 及 这 些 问 题 未 能 消除 的 原因 。 
A. 4.6 技术 条 件 方面 的 可 行 性 
本 节 应 说 明 技术 条 件 方面 的 可 行 性 ,如 ， 
a. 在 当前 的 限制 条 件 下 ,该 系统 的 功能 目标 能 否 达到 ; 
b. 利用 规 有 的 技术 ,该 系统 的 功能 能 否 实现 
`e。 对 开发 人 员 的 数量 和 质量 的 要 求 并 说 明 这 些 要 求 能 否 满足 ; 
a 在 规定 的 期 限 内 ,本 系统 的 开发 能 否 完 成 。 / 


A.5 可 选择 的 其 他 系统 方案 


扼要 说 明 曾 考虑 过 的 每 一 种 可 选择 的 系统 方案 ， 包括 需 开 发 的 和 可 从 国内 国外 直接 购买 的 ， 如 果 没 
有 供 选择 的 系统 方案 可 考虑 , 则 说 明 这 一 点 。 
A.5.1 可 选择 的 系统 方案 1 
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参照 第 A. 4 章 的 提纲 ， 涪 明 可 光 拉 的 系统 方案 1, 并 洲 明 它 来 名 地 中 的 理由 . 
A.5.2 可 选择 的 系统 方案 2 
按 类 似 A. 5. ! 条 的 方式 说 明 第 2 个 乃至 第 ， 个 可 选择 的 系统 方案 。 


A.6 投资 及 效益 分 析 


A-6.1 支出 
对 于 所 选择 的 方案 ， 涪 明 所 需 的 费用 . 如 果 已 有 一 个 现存 系统 , 则 包括 该 系统 继续 运行 期 间 所 需 的 
费用 。 
A.6.1.1 基本 建设 投资 
包括 采购 、 开发 和 安装 下 列 各 项 所 逢 的 费用 ， 如 ， 
房屋 和 设施 ， 
， ADP 设备 ， 
数据 通讯 设备 ， 
环境 保护 设备 
”安全 与 保密 设备 ， 
ADP 操作 系统 的 和 应 用 的 软件 ; 
数据 库 管理 软件 。 
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A.6.1.2 其 他 一 次 性 支出 
包括 下 列 各 项 所 需 的 费用 ,如 : 

研究 (需求 的 研究 和 设计 的 研究 )， 

开发 计划 与 测量 基准 的 研究 ， 
数据 库 的 建立 ; 
ADP 软件 的 转换 ， 
检查 费用 和 技术 管理 性 费用 ， 
培训 费 、 旅 差 费 以 及 开发 安装 人 员 所 需要 的 一 次 性 支出 ， 
人 员 的 退休 及 调动 费用 等 。 
A. 6.1.3 非 一 次 性 支出 

列 出 在 该 系统 生命 期 内 按 肯 或 按 地 或 按 年 支出 的 用 子 运 行 和 维护 的 费用 ， 包括 ， 
a， 设备 的 租金 和 维护 费用 ， 

b. 软件 的 租金 和 维护 费用 ， 

c. ”数据 通讯 方面 的 租金 和 维护 费用 ， 
d. 人 员 的 工资 .奖金 
多 


Wn “eo on ys 


房屋 、 空 间 的 使 用 开支 ， 
公用 设施 方面 的 开支 
. 保密 安全 方面 的 开支 
h. 其 他 经 常 性 的 支出 等 。 
A. 6.2 收益 z 
对 于 所 选择 的 方案 ,说 明 能 够 带 来 的 收益 ,这 里 所 说 的 收益 ,表现 为 开支 费用 的 减少 或 进 免 .差错 的 
减 改 ` 灵 活性 的 增加 、 动作 乏 度 的 提高 和 和 营 理 计划 让 而 的 改进 等 \ 自 括 ， 
A.6.2.1 一 次 性 收益 
说 明 能 够 用 人 民 币 数目 表示 的 一 次 性 收益 , 丰 可 按 数据 处 理 、 用 户 、 管理 和 支持 等 项 分 类 各 述 ， 如 ; 
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a. 开支 的 缩减 包括 改进 了 的 系统 的 运行 所 引起 的 开支 缩减， 如 资源 要 求 的 减少 ,运行 效率 的 改 
进 , 数 据 进入 、 存 贮 和 恢复 技术 的 改进 ,系统 性 能 的 可 监控 ,软件 的 转换 和 优化 ， 数据 压缩 技术 的 采用 ， 处 
理 的 集中 化 /分 布 化 等 ; 

b. 价值 的 增 升 包括 由 于 一 个 应 用 系统 的 使 用 价值 的 增 升 所 引起 的 收益 ,如 资源 利用 的 改进 , 管 
理 和 运行 效率 的 改进 以 及 出 错 率 的 减少 等 ， 

c. 其 他 如 从 多 余 设 备 出 舍 回 收 的 收入 等 。 

A.6.2.2 非 一 次 性 收益 

说 明 在 整个 系统 生命 期 内 由 于 运行 所 建议 系统 而 导致 的 按 月 的 、 按 年 的 能 用 人 虹 币 数目 表示 的 收 
益 ,包括 : 开 支 的 减少 和 避免 。 

A.6,2. 3 到 可 定量 的 收益 
逐 项 列 出 元 法 直接 用 人 民 币 表示 的 收益 ， 如 服务 的 改进 ， 由 操作 失误 引起 的 风险 的 减少 ， 信息 掌握 
情况 的 改进 ,组 织 机 构 给 外 界 形象 的 改善 等 有 些 不 可 捉摸 的 收益 只 :能 大 概 估 计 或 进行 极 值 枯 计 ( 按 最 
好 和 最 差 情 况 估 计 ); z : 
^. .3 收益 /投资 比 
求 出 整个 系统 生命 期 的 收益 /投资 比值 。 
A. 6.4 投资 回收 周期 
求 出 收益 的 累计 数 开始 超过 支出 的 累计 数 的 时 间 。 
A.6.5 敏感 性 分 析 
”所 谓 敏感 性 分 析 是 指 一 些 关 键 性 因素 如 系统 生命 期 长 度 、 系统 的 工作 负荷 量 、 工作 负荷 的 类 型 与 这 
些 不 同类 型 之 间 的 合理 搭配 .处 理 速度 要 求 . 设 备 和 软件 的 配置 等 变化 时 ,对 开支 和 收益 的 影响 最 灵敏 
的 范围 的 估计 。 在 敏感 性 分 析 的 基础 上 做 出 的 选择 当然 全 比 单一 饮 择 的 结果 要 好 ” 些 ， 


A.7 社会 因素 方面 的 可 行 性 


本 章 用 来 说 明 对 社会 因 来 方面 的 可 行 性 分 析 的 结果, 包括 ， 
A.7.1 法 律 方 面 的 可 行 性 
法 律 方面 的 可 行 性 问题 很 多 ,如 合同 责任 、 侵犯 专利 权 、 侵犯 版 权 等 方面 的 陷 并 ， 软件 人 员 通 常 是 不 
熟悉 的 ,有 可 能 陷入 ,务必 要 注意 研究 。 
A.7.2 使 用 方面 的 可 行 性 ” 
例如 从 用 户 单位 的 行政 管理 、 工作 制度 等 方面 来 看 ， 是 否 能 够 使 用 该 该 软件 系统 :从 用 思 单 位 的 工作 
人 员 的 素质 来 看 ,是 否 能 满足 使 用 该 软件 系统 的 要 求 等 等 ,都 是 要 考虑 的 。 


A. 8 结论 


在 进行 可行 人 研究 的 入 凶 时 " 必须 有 一 个 研究 的 结论 ， 结论 可 以 是 : 

a. 可 以 立即 开始 进行 

b. 希 要 推迟 到 菜 些 条 件 ( 例 如 资金 人 力 、 设备 等 ) 落 实 之 后 才能 开始 进行 ， 
c， 需要 对 开发 目标 进行 菜 些 修改 之 后 才能 开始 进行 ， | 

d， 不 能 进行 或 不 必 进 行 ( 例 如 因 技术 不 成 熟 . 经 济 上 不 合算 等 )。 
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“附录 :8 
项 目 开发 计划 的 编写 提示 


《参考 件 ) 
B.1 引言 . 
.1.1. 编写 目的 
说 明 编 写 这 份 项 目 开发 计划 的 目的 ,并 指出 预期 的 读者 。 
B. 1.2 此生 
机 
“等 开发 的 软件 系统 的 名 称 ; 


b. 本 项 目的 任务 提出 者 .开发 者 .用 户 及 实现 该 软件 的 计算 中 心 或 计算 机 网 络 ， 

c. 该 软件 系统 同 其 他 系统 或 其 他 机 构 的 基本 的 相互 来 往 关 系 、 
B. 1.3 定义 

列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文 首 字母 组 词 的 原 词组 、 
B.1.4 参考 资料 

列 出 用 得 着 的 参考 资料 ,如 : 

a. ”本 项 目的 经 核准 的 计划 任务 书 或 合同 、 上 级 机 关 的 批文 ， 

属于 本 项 目的 其 他 已 发 表 的 文件 ; 
c. 本 文件 中 各 处 引用 的 文件 ,资料 ,包括 所 要 用 到 的 软件 开发 标准 ， 
列 出 这 些 文件 资料 的 标题 .文件 编号 .发表 日 期 和 出 版 单位 ,说 明 能 够 得 到 这 些 文件 资料 的 来 产 。 


 B.2? 项 目 概述 


B.2.1 工作 内 容 
一 简要 地 说 明 在 本 项 目的 开发 中 须 进 行 的 各 项 主要 工作 。 
8.2.2 主要 参加 和 人员 
扼要 襄 明 参加 本 项 目 开发 工作 的 主要 人 员 的 情况 ， 包括 他 们 的 技术 水 平 。 
下 .2.3 产品 
B.2.3.1 程序 
列 出 需 移交 给 用 户 的 程序 的 名 称 . 所 用 的 编程 语言 及 存储 程序 的 媒体 形式 ,并 通过 引用 有 关 文件 ， 
奸 项 说 明 其 功能 和 人 能力。 
B. 2. 3.2 文件 
列 出 需 移 交 给 用 户 的 每 种 文件 的 名 称 及 内 容 要 点 . 
B. 2. 3.3 服务 
列 出 需 向 用 户 提供 的 各 项 服务 ， 如 培训 安装 ,维护 和 运行 支持 竺 ,应 逐 项 规定 开始 日 期 \、 所 提供 支持 
”的 级 别 和 服务 的 期 限 。 
B. 2.3.4 非 移交 的 产品 
说 明 开 发 集体 应 向 本 单位 交 出 但 不 必 向 用 户 移 交 的 产品 (文件 其 至 某 些 程序 ) 
. B.2.4 验收 标准 
对 于 上 述 这 些 应 交 出 的 产品 和 服务 ， 逐 项 说 明 或 引用 资料 说 明 验收 标准 
B. 2.5 完成 项 目的 最 迟 期 限 
 B.2.6 本 计划 的 批准 者 和 批准 日 期 
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B,.5 实施 计划 


B. 3.1 工作 任务 的 分 解 与 人 员 分 工 六 
对 于 项 目 开 发 中 需 完成 的 各 项 工作 ,从 需求 分 析 设计、 实现 .测试 直到 维护 ,包括 文件 的 编制 、. 审 
批 \ 打 印 .分 发 工作 ,用 户 培训 工作 ,软件 安装 工作 等 , 按 层次 进行 分 解 , 指 明 每 项 任务 的 负责 人 和 参加 人 
员 。 
B. 3. 2 接口 人 员 
说 明 负 责 接口 工作 的 人 员 及 他 们 的 职责 ,包括 : 
a， 负责 本 项 目 同 用 户 的 接口 人 员 ， 
b. 负责 本 项 目 同 本 单位 各 管理 机 构 ， 如 合 风 计 划 管 理 部 站 、 财务 部 门 、 质量 管理 部 门 等 的 接口 人 
员 ， 
ec. 负责 本 项 目 同 各 分 合同 负责 单位 的 接口 人 员 等 。 
B. 3.3 进度 
z 对 于 需求 分 析 . 设 计 . 编 码 实现, 测 请 ;移交 , 搓 训 和 洋装 芷 工作 ,给 册 每 项 工作 任务 的 预定 开始 
期 、 完 成 日 期 及 所 需 资 源 , 规 定 各 项 工作 任务 完成 的 先后 顺序 以 及 表征 每 项 工作 任务 完成 的 标志 性 事件 
( 即 所 谓 “ 里 程 碑 ”) 。 
B. 3.4 预算 
逐 项 列 出 本 开发 项 目 所 需要 的 劳务 (包括 人 员 的 数量 和 时 间 ) 以 及 经 费 的 预算 (包括 办 公费 、 差 旅 
” 费 、 机 时 费 , 资 料 费 、 通 讯 设备 和 专用 设备 的 租金 刍 ) 和 来 源 。 
B. 3.5 关键 问题 
逐 项 列 出 能 够 影响 整个 项 站 成 下 的 关键 问题 数 术 难点 和 风险 ， 指出 这 些 问题 对 项 目的 影响 。 


B.4 支持 条 件 


说 明 为 支持 本 项 目的 开发 所 需要 的 各 种 条 件 和 设施 。 
B. 4. 1 计算 机 系统 支持 
“过 项 列 出 开发 中 和 运行 时 挤 禹 的 评 算 松 系 绕 支 持 ， 包括 计算 机 、 外 围 设备 .通讯 设备 .模拟 器 .编译 
(或 汇编 ) 程 序 、 操作 系统 ， 数据 管理 程序 包 、 数据 存储 能 力 和 测试 支持 能 力 等 ， 逐 项 给 出 有 关 到 货 日 期 、 
使 用 时 间 的 要 求 。 
“B.4.2 需 由 用 户 承 担 的 工作 
逐 项 列 出 需要 用 户 承 担 的 工作 和 完成 期 限 , 包 括 需 由 用 户 提供 的 条 件 及 提供 时 间 。 
4 需 由 外 单位 提供 的 条 件 
_ 逐 项 列 出 需要 外 单位 分 合 回 承 但 岩 承 得 的 工作 和 响 成 的 时 间 ， 包括 需要 由 外 单位 提供 的 条 件 和 提 
供 的 时 间 ， 


B. 5 专题 计划 要 点 


说 明 本 项 目 开 发 中 需 制订 的 各 个 专题 计划 (如 分 合同 计划 、 开 发 人 员 溢 训 计划 、 测 试 计划 、 安 全 保密 
计划 、 质 量 保证 计划 、 配 置 管理 计划 、 用 户 培训 计划 ,系统 安装 计划 等 ) 的 要 点 。 
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附 录 CcC 


软件 需求 说 明 书 的 编写 提示 
《参考 件 ) 
Cc.1 引言 
c.1.1 编写 目的 
说 明 编 写 这 份 软件 需求 说 明 书 的 目的 ， 指出 预期 的 读者 ， 
C.1.2 背景 
说 明 ， 


a, 待 开发 的 软件 系统 的 名 称 ; 
b. 本 项 目的 任务 提出 者 .开发 者 、 用 户 及 实现 该 软件 的 计算 中 心 或 计算 机 网 络 ， 
c. 该 软件 系统 财 其 他 系统 或 其 由 机 构 的 基本 的 相互 来 往 关系 。 
C1.3 定义 
列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文 首 字母 组 词 的 原 词组 ， 
C.1.4 参考 资料 
a. 本 项 目的 经 核准 的 计划 任务 书 或 合同 、 土 级 机 关 的 批文 ; 
b. 局 于 本 项 目的 其 他 已 发 表 的 文件 ， 
ce. 本 文件 中 名 姓 绰 用 的 文件 ,资料 ,包括 疾 要 用 到 的 软 御 开发 标准 。 
列 出 这 些 文件 资料 的 标题 ,文件 编号 ,发 表 日 期 和 出 版 单位 ， 说 明 能 名 得 到 这 些 文件 资料 的 来 源 


Cc.2? 任务 概述 


c.2.1 目标 
:入 述 该 项 软 伞 开发 的 音 图 ; 阿 昌 四 标 ,作用 范 图 以 及 其 他 应 向 读者 说 明 的 有 关 该 软件 开发 的 消暑 
肌 名称 村 开发 坎 件 与 芝 他 有 关 软件 之 间 的 关系 .如果 本 软件 产品 是 -项 独立 的 软件 ， 而 且 全 部 内 容 自 
含 , 则 说 明 这 一 点 。 如 果 所 定义 的 产品 是 一 个 更 大 的 系统 的 一 个 组 成 部 分 , 则 应 说 明 本 产品 与 该 系统 中 
其 他 各 组 成 部 分 之 间 的 关系 ,为 此 可 使 用 一 一 张 方 框图 来 说 明 该 系统 的 组 成 和 本 产品 同 其 他 各 部 分 的 联 
系 和 接口 。 
c.2.2 用 户 的 特点 
“ 列 出 本 软件 的 聂 络 用 户 的 特点 ;充分 说 明报 作 人 员 、 维护 人 员 的 教育 水 平和 技术 专长， 以 及 本 软件 
的 预期 使 用 频 度 .这 些 是 软件 设计 工作 的 重要 约束 。 
£.2.3 假定 和 约 东 
列 出 进行 本 软件 开发 工作 的 假定 和 约束 ,例如 经 费 限 制 、 开 发 期 限 等 。 
Cc. 3 需求 规定 
C. 3.1 对 功能 的 规定 
用 列表 的 方式 (例如 IPO 表 即 输入 、 处 理 、 输出 表 的 形式 ), 逐 项 定量 和 定性 地 叙述 对 软件 所 提出 的 
功能 要 求 , 说 明 输 入 什么 量 、 经 怎样 的 处 理 、 得 到 什么 输出 ,说 明 软 件 应 支持 的 终端 数 和 应 支持 的 并 行 模 
作 的 用 户 数 ， 
c. 3.2 对 性 能 的 规定 
c.3.2.1 精度 
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说 明 对 该 软件 的 输入 、 输 出 数据 精度 的 要 求 ,可 能 包括 传输 过 程 中 的 精度 。 
C. 3.2.2 时 间 特 性 要 求 
说 明 对 于 该 软件 的 时 间 特 性 要 求 ， 各 对 ; 
a 啊 应 时 间 ; 
b. 更 新 处 理 时 间 ; 
c. ”数据 的 转换 和 传送 时 间 ， 
d， 解 题 时 间 ; 
等 的 要 求 。 
C. 3.2.3 灵活 性 
说 明 对 该 软件 的 灵活 性 的 要 求 , 即 当 需 求 发 生 某 些 变化 时 ,该 软件 对 这 些 变化 的 适应 能 力 ,如 : 
操作 方式 上 的 变化 ， 
运行 环境 的 变化 ; 
‘. 阅 其 他 软件 的 接口 的 变化 ，; 
精度 和 有 效 时 限 的 变化 ; 
计划 的 变化 或 改进 。 
对 于 为 了 提供 这 些 灵活 性 而 进行 的 专门 设计 的 部 分 应 该 加 以 标明 。 
C.3.3 输入 输出 要 求 
解释 各 输入 输出 数据 类 型 ,并 逐 项 说 明 其 媒体 、 格式 、 数值 范围 .精度 等 。 对 软件 的 数据 输出 及 必须 
标明 的 控制 输出 量 进行 解释 并 举例 ， 包括 对 而 持 由 报 告 (正常 结果 输出 、 状态 输出 及 异常 输出 ) 以 及 图 形 
或 显示 报告 的 描述 。 
C. 训 4 数据 管理 能 力 要 求 
说 明 需 要 管理 的 文 卷 和 记录 的 个 数 、 表 和 文 卷 的 大 小 规模 ， 要 按 可 预见 的 增长 对 数据 及 其 分 量 的 存 
储 要 求 作 出 估算 。 
5.3.5 故障 处 理 要 求 
` 列 出 可 能 的 软件 、 杰 件 故障 以 及 对 各 项 性 能 而 言 所 产生 的 后 果 和 于 故 库 处 理 的 要 求 ; 
C. 不 百 其 他 专门 要 求 
其 用户 单位 对 安全 保密 的 要 求 , 对 使 用 方便 的 要 求 , 对 可 维护 性 .可 补充 性 、 易 读 性 .可 车 性 .运行 环 
境 可 转换 性 的 特殊 要 求 等 。 


C.4 运行 环境 规定 


C. 4.1 设备 
列 出 运 运行 该 软件 所 需要 的 硬 设备 。 说 明 其 中 的 新 型 设备 及 其 专门 功能 ,包括 : 
处 理 器 型 号 及 内 存 容量 
外 存 容量 、 联 机 或 脱 机 .媒体 及 其 存储 客 式 ,设备 的 型 号 及 数量 ， 
输入 及 输出 设备 的 型 号 和 数量 ,联机 或 脱 机 ， 
数据 通信 设备 的 型 号 和 数量 ， 
ee。 功能 键 及 其 他 专用 硬件 ， 
C. 4.2 支持 软件 
列 出 支持 软件 ， 包括 要 用 到 的 操作 系统 、 编译 (或 汇编 ) 程 序 .测试 支持 软件 等 。 
C.4.5 接 DO 
说 明 该 区 软件 同 其 他 软件 之 间 的 接口 、 数据 通信 协议 等 。 
Cc. 4.4 控制 
说 明 控 制 该 软件 的 运行 的 方法 和 控制 信号 ,并 说 明 这 些 控制 信号 的 来 源 。 
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附 有 录 D 


数据 要 求 说 明 书 的 编写 提示 
(参考 件 ) 
D. 1 引言 
D. 1.1 编写 日 的 
”说 明 编写 这 份 数据 要 求 说 明 书 的 目的 ,指出 预期 的 读者 。 
D.1.2 背景 


说 明 
a. 待 开 发 软件 系统 的 名 称 ; 
_b. 列 出 本 项 目的 任务 提出 者 .开发 者 .用户 以 及 将 运行 该 项 软件 的 计算 站 (中 心 ?或 计算 机 网 络 系 
统 ， z 
D.1.3 定义 
列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文字 母 组 词 的 原 词组 ， 
D. 1.4 参考 资料 
列 出 有 关 的 参考 资料 ,如 : 
a. 本 项 目的 经 核准 的 计划 任务 书 或 合同 ,上 级 机 关 的 批文， 
b. 属于 本 项 目的 其 他 已 发 表 文件 ; : 
ce. 本 文件 中 各 处 引用 的 文件 ,资料 ,包括 所 要 用 到 的 软件 开发 标准 . 列 出 这 些 文件 的 标题 .文件 编 
号 .发 表 日 期 和 出 版 单位 .说 明 能 够 得 到 这 些 文件 资料 的 来 源 。 


D. 2 数据 的 逻辑 描述 


对 数据 进行 逻辑 描述 时 可 把 数据 分 为 动态 数据 和 静态 数据 .所 谓 静态 数据 , 指 在 运行 过 程 中 主要 作 
为 参考 的 数据 ,它们 在 很 长 的 一 段 时 间 内 不 会 变化 ,一般 不随 运行 而 改变 。 所 谓 动 态 数据 ,包括 所 有 在 运 
行 中 要 发 生变 化 的 数据 以 及 在 运行 中 要 输入 、 输 出 的 数据 .进行 描述 时 应 把 各 数据 元 素 逻 辑 地 分 成 若干 
组 , 列 如 函数 . 源 数据 或 对 于 其 应 用 更 为 恰当 的 逻辑 分 组 ,给 出 每 一 数据 元 的 名 称 (包括 缩写 和 代码 )、 定 
义 (或 物理 意义 ) 度 量 单位 \ 值 域 .格式 和 类 型 等 有 关 信息 。 
D.2.1 静态 数据 
列 出 所 有 作为 控制 或 参考 用 的 静态 数据 元 素 。 
D. 2.2 动态 输入 数据 
列 出 动态 输入 数据 元 素 ( 包 括 在 常规 运行 中 或 联机 操作 中 要 改变 的 数据 ). 
D. 2.3 动态 输出 数据 
列 出 动态 输出 数据 元 素 ( 包 括 在 常规 运行 中 或 联机 操作 中 要 改变 的 数据 )， 
D. 2. 4 内 部 生成 数据 
列 出 向 用 户 或 开发 单位 中 的 维护 调试 人 员 提供 的 内 部 生成 数据 。 
.D.2.5 数据 约定 
说 明 对 数据 要 求 的 制约 。 逐 条 列 出 对 进 一 _ 步 扩充 或 使 用 方面 的 考虑 而 提出 的 对 数据 要 求 的 限制 ( 容 
量 、 文 卷 . 记 录 和 数据 元 的 个 数 的 最 大 值 )。 对 于 在 设计 和 开发 中 确定 是 临界 性 的 限制 更 要 明确 指出 。 


D. 3、 数 据 的 采集 
D. 3.1 要 求 和 范围 
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按 数 据 元 的 逻辑 分 组 来 说 明 数据 采集 的 要 求 和 范围 ， 指明 数据 的 采集 方法 ， 说 明 数据 采集 工作 的 承 
担 者 是 用 户 还 是 开发 者 .具体 的 内 容 包 括 ，; 

a. 输入 数据 的 来 源 ,例如 是 单个 操作 员 、 数 据 输入 站 ， 专业 的 数据 输入 公司 或 它们 的 一 个 分 组 ， 

b. 数据 输入 ( 指 把 数据 输入 处 理 系 统 内 部 ) 所 用 的 媒体 和 硬 设备 ,如 果 只 有 指定 的 输入 点 的 输入 
才 是 合法 的 , 则 必须 对 此 加 以 说 明 ， 

c. 接受 者 ”说明 输出 数据 的 接受 者 ， 

d. 输出 数据 的 形式 和 设备 列 出 输出 数据 的 形式 和 硬 设 备 。 元 论 接 受 者 将 接收 到 的 数据 是 打印 
输出 ,还 是 CRT 上 的 一 组 字符 .一 帧 图 形 ,或 一 声 警 铃 , 或 向 开关 线圈 提供 的 一 个 电 脉冲 ,或 常用 介质 如 
磁盘 .磁带 .穿孔 卡片 等 , 均 应 具体 说 明 ; 

e. 数据 值 的 范围 给 出 每 一 个 数据 元 的 合法 值 的 范围 ， 

ft. 量 纲 给 出 数字 的 度量 单位 , 增 景 的 步 长 、 零点 的 定 标 等 。 在 数据 是 非 数 字 量 的 情况 下 ， 要 给 出 
每 一 种 合法 值 的 形式 和 含意 ; 

g. 更 新 和 处 理 的 频 度 给 出 预定 的 对 输入 数据 的 更 新 和 处 理 的 频 度 ， 如 果 数 据 的 输入 是 随机 的 ， 

应 给 出 更 新 处 理 的 频 度 的 平均 值 ,或 变化 情况 的 某 种 其 他 度量 。 
D.3 2 输入 的 承担 者 

说 明 预 定 的 对 数据 输入 工作 的 承担 者 。 如 果 输 入 数据 同 某 一 接口 软件 有 关 , 还 应 说 明 该 接口 软件 的 
来 源 。 

D. 535.3 预 处理 z 

对 数据 的 采集 和 预 处 理 过 程 提出 专门 的 规定 ,包括 适合 应 用 的 数据 格式 ,预定 的 数据 通信 媒体 和 对 
输入 的 时 间 要 求 等 。 对 于 需 经 模拟 转换 或 数字 转换 处 理 的 数据 量 ， 要 给 出 转换 方法 和 转换 因子 等 有 关 信 
息 ， 以 便 软件 系统 使 用 这 些 数据 。 

D. 5. 4 影响 

说 明 这 些 数 据 要 求 对 于 设备 .软件 ,用户 .开发 单位 所 可 能 产生 的 影响 ,例如 要 求 用 片 : 单 位 着 设 某 个 

机 构 等 。 


GB 8567 一 88 





附 录 EE 
概要 设计 说 明 书 的 编写 提示 
(参考 件 ) 
E.1 引 富 
E.1.1 编写 目的 
说 明 编 写 这 份 概要 设计 说 明 书 的 目的 ,指出 预期 的 读者 。 
E. 1. 2 ”和 背 蚌 
说 明 : 


a， 待 开发 软件 系统 的 名 称 ; 
b， 列 出 此 项 目的 任务 提出 者 .开发 者 .用 户 以 及 将 运行 该 软件 的 计算 站 (中心 )。 
E.1.3 定义 : : 
列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文 首 字母 组 词 的 原 词组 。 
E,1.4 参考 资料 
列 出 有 关 的 参考 文件 ,如 : 
a. ”本 项 目的 经 核准 的 计划 任务 书 或 合同 ,上 级 机 关 的 批文 ， 
b. 属于 本 项 目的 其 他 已 发 表 文件 ; 
ec. 本 文件 中 各 处 引用 的 文件 .资料 ,包括 所 要 用 到 的 软件 开发 标准 。 
” 列 出 这 些 文件 的 标题 .文件 编号 ,发 表 日 期 和 出 版 单位 ,说 明 能 够 得 到 这 些 文件 资料 的 来 源 。 
E.2 总 体 设计 
E. 2. 1 需求 规定 
说 明 对 本 系统 的 主要 的 输入 输出 项 目 . 处 理 的 功能 性 能 要 求 ,详细 的 说 明 可 参见 附录 C。 
E.2.2 运行 环境 
简要 地 说 明 对 本 系统 的 运行 环境 (包括 硬件 环境 和 支持 环境 ) 的 规定 ,详细 说 明 参 见 附录 C。 
E. 2.5 基本 设计 概念 和 处 理 流程 
说 明 本 系统 的 基本 设计 概念 和 处 理 流程 ,尽量 使 用 图 表 的 形式 。 
E.2.4 结构 
用 一 览 表 及 框图 的 形式 说 明 本 系统 的 系统 元 素 ( 各 层 模 块 . 子 程序 .公用 程序 等 ) 的 划分 ,扼要 说 明 
每 个 系统 元 素 的 标识 符 和 功能 ,分 层次 地 给 出 各 元 素 之 间 的 控制 与 被 控制 关系 。 
E.2.5 功能 需求 与 程序 的 关系 
本 条 用 一 张 如 下 的 矩阵 图 说 明 各 项 功能 需求 的 实现 同 各 块 程序 的 分 配 关系 ， 
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.9.6 人 工 处 理 过 各 
说明 在 本 软件 系统 的 工作 过 程 中 不 但 不 包 售 的 人 工 处 理 过 各 (如 果 有 的 话 。 
E. 2.7 尚未 解决 的 问题 
说 明 在 概要 设计 过 程 中 尚 米 解决 而 设计 者 认为 在 系统 完成 之 前 必须 解决 的 吉 个 何 题 。- 


E. 3 接口 设计 


“EE.3.1 用 户 接口 
说 明 将 向 用 户 提供 的 命令 和 它们 的 语法 结构 ， 以 及 软件 的 回答 信息 。 
E. 3.2 外 部 接口 
说 明 本 系统 同 外 界 的 所 有 接口 的 安排 包括 软件 与 硬件 之 间 的 接 串 、 本 系统 与 各 支持 软件 之 间 的 粮 
口 关 系 。 : 
E. 3.3 内 部 接口 
说 明 本 系统 之 内 的 各 个 系统 元 素 之 间 的 接口 的 安排 。 


E. 4 运行 设计 


E. 4. 1 运行 模块 组 合 
说 明 对 系统 施加 不 同 的 外 界 运行 控制 时 所 引起 的 各 种 不 同 的 运行 模块 组 合 ,说 明 每 种 运行 所 历经 
的 内 部 模块 和 支持 软件 。 
E, 4. 2 运行 控制 / 
说 明 每 一 种 外 界 的 运行 控制 的 方式 方法 和 操作 步 台 。 
E. 4.3 运行 时 间 
说 明 每 种 运行 模块 组 合 将 占用 各 种 资源 的 时 间 ， 


E.5 系统 数据 结构 设计 


E.5.1 逻辑 结构 设计 要点 

给 出 本 系统 内 所 使 用 的 每 个 数据 结构 的 名 称 、 标 识 符 以 及 它们 之 中 每 个 数据 项 、 记 录 、 文 卷 和 系 的 
标识 .定义 ,长 度 及 它们 之 间 的 层次 的 或 表格 的 相互 关系 。 
E. 5.2 物理 结构 设计 要 点 

给 出 本 系统 内 所 使 用 的 每 个 数据 结构 中 的 每 个 数据 项 的 存储 要 求 , 访 问 方法 , 存 取 单 位 , 存 取 的 物 
理 关 系 ( 索 引 、 设 备 .存储 区 域 ). 设 计 考 虑 和 保密 条 件 。 
E. 5. 3 数据 结构 与 程序 的 关系 

说 明 各 个 数据 结构 与 访问 这 些 数据 结构 的 各 个 程序 之 间 的 对 应 关系 ,可 采用 如 下 的 乱 阵 图 的 形式 ， 
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E.6 系统 出 错 处 理 设计 


E. 6. 1 出 错 信息 

用 一 览 表 的 方式 说 明 每 种 可 能 的 出 错 或 故障 情况 出 现时 4 系统 输出 信息 的 形式 、 会意 及 处 理 方法 。 
E. 6. 2 补救 措施 

说 明 故 障 出 现 后 可 能 采取 的 变通 措施 ,包括 : 

a， 后 备 技 术 说 明 准 备 采 用 的 后 备 技术 , 当 原 始 系统 数据 万 一 丢失 时 启用 的 副本 的 建立 和 启动 
的 技术 ,例如 周期 性 地 把 磁盘 信息 记录 到 磁带 上 去 就 是 对 于 磁盘 媒体 的 一 种 后 备 技术 ， 

b， 降 效 技术 说 明 准 备 采用 的 后 备 技术 ,使 用 另 一 个 效率 稍 低 的 系统 或 方法 来 求 得 所 需 结果 的 
某 些 部 分 ,例如 一 个 自动 系统 的 降 效 技术 可 以 是 手工 操作 和 数据 的 人 工 记录 ; 

c， 恢复 及 再 启动 技术 说 明 将 使 用 的 恢复 再 启动 技术 ,使 软件 从 故障 点 恢复 执行 或 使 软件 从 头 
开始 重新 运行 的 方法 。 

E. 6.3 系统 维护 设计 

说 明 为 了 系统 维护 的 方便 而 在 程序 内 部 设计 中 作出 的 安排 ,包括 在 程序 中 专门 安排 用 于 系统 的 检 
查 与 维护 的 检测 点 和 专用 模块 。 
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附 景 FF 


详细 设计 说 明 书 的 编写 提示 
(参考 件 ) 
F.1 引言 
F. 1.1 编写 目的 
说 明 编写 这 份 详 纺 设 计 说 明 书 的 目的 ， 指出 预期 的 读者 。 
F.1.2 篆 景 


说 明 : 

a， 符 开 发 软件 系统 的 名 称 ; 

b. 本 项 目的 任务 提出 者 .开发 者 ,用 户 和 运行 该 程序 系统 的 计算 中 心 。 
F.1.3 定义 

列 出 本 文件 中 用 到 专门 术语 的 定义 和 外 文 首 字母 组 词 的 原 词组 。 
F.1.4 参考 资料 

列 出 有 关 的 参考 资料 ,如 ， 

a. 本 而 目的 经 核准 的 计划 任务 书 或 合同 、 上 级 机 关 的 批文 

属于 本 项 目的 其 他 已 发 表 的 文件 ; 

ce. 本 文件 中 各 处 引用 到 的 文件 资料 ,包括 所 要 用 到 的 软件 开发 标准 。 
列 出 这 些 文件 的 标题 .文件 编号 ,发表 日 期 和 出 版 单位 ,说 明 能 够 取得 这 些 文件 的 来 源 。 


F.2 程序 系统 的 结构 


用 一 系列 图 表 列 出 本 程序 系统 内 的 每 个 程序 (包括 每 个 模块 和 子 程序 ) 的 名 称 、 标 识 符 和 它们 之 间 
的 层次 结构 关系 。 / / 


F.5 程序 1( 标 识 符 ) 设 计 说 明 


从 本 章 开始 ,逐个 地 给 出 各 个 层次 中 的 每 个 程序 的 设计 考虑 .以 下 给 出 的 提纲 是 针对 一 般 情况 的 。 
对 于 一 个 具体 的 模块 ,尤其 是 层次 比较 低 的 模块 或 子 程序 ,其 很 多 条 目的 内 容 往往 与 它 所 隶属 的 上 一 层 
模块 的 对 应 条 目的 内 容 相同 ,在 这 种 情况 下 ,只 要 简单 地 说 明 这 一 点 即 可 。 
F.3.1 程序 描述 
给 出 对 该 程序 的 简要 描述 ， 主要 说 明 安排 设计 本 程序 的 目的 意义 ， 并 且 , 还 要 说 明 本 程序 的 特点 (如 
是 党 对 内 存 还 是 非常 上 ?是 否 子 程序 ?是 可 重 入 的 还 是 不 可 重 入 的 ?有 无 关 要 求 ?是 是 序 处 理 还 是 并 


F. 3.2 功能 
说 明 该 程序 应 具有 的 功能 ， 可 采用 IPO 图 ( 即 输 入 一 处 理 一 输出 图 ) 的 形式 。 
F. 3.3 性 能 
说 明 对 该 程序 的 全 部 性 能 要 求 , 包 括 对 精度 、 灵 活性 和 时 间 特 性 的 要 求 。 
F. 3.4 输入 项 
. 给 出 对 每 一 个 输入 项 的 特性 ,包括 名 称 、 标 识 .数据 的 类 型 和 格式 、 数据 值 的 有 效 范围 输入 的 方式 、 
”数量 和 频 度 、 输 入 媒体 、 输入 数据 的 来 源 和 安全 保密 条 件 等 等 。 
”FF.3.5 输出 项 
给 出 对 每 一 个 输出 项 的 特性 ,包括 名 称 、 标 识 、 数据 的 类 型 和 格式 ， 数据 值 的 有 效 范围 ， 输出 的 形式 、 
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数量 和 频 度 ,输出 媒体 、 对 输出 图 形 及 符号 的 说 明 、 安 全 保密 条 件 等 等 。 

F. 3.6 算法 

详细 说 明 本 程序 所 选用 的 算法 ,具体 的 计算 公式 和 计算 步骤 。 

F. 3.7 流程 逻辑 

用 图 表 ( 例 如 流程 图 、 判定 吉 等 ) 畏 以 必要 的 说 明 来 表示 本 程序 的 逻辑 流 程 

F.3.8 接口 

用 图 的 形式 说 明 本 程序 所 隶属 的 上 一 层 模块 及 隶属 于 本 程序 的 下 一 层 模块 . 子 程序 ,说 明 参 数 赋值 
和 调用 方式 ,说 明 与 本 程序 相 直 接 关联 的 数据 结构 (数据 库 .数据 文 卷 )。 

F. 3.9 存储 分 配 

根据 需要 ,说 明 本 程序 的 存储 分 配 .。 

F. 5.10 注释 设计 

说 明 准 备 在 本 程序 中 安排 的 注释 ,如 : 

a. 加 在 模块 首部 的 注释 ; 

b. 加 在 各 分 枝 点 处 的 注释 ; 

ec. 对 各 变量 的 功能 .范围 . 缺 省 条 件 等 所 加 的 注释 ; 

4d. 对 使 用 的 逻辑 所 加 的 注释 等 等 。 

F. 3.11 限制 条 件 

说 明 本 程序 运行 中 所 受到 的 限制 条 件 。 

F. 3.12 测试 计划 

说 明 对 本 程序 进行 单 体 测试 的 计划 ,包括 对 测试 的 技术 要 求 . 输 入 数据 、 预 期 结果 、 进 度 安 排 人员 
职责 .设备 条 件 驱动 程序 及 桩 模块 等 的 规定 。 

F. 3.13 尚未 解决 的 问题 

说 明 在 本 程序 的 设计 中 尚未 解决 而 设计 者 认为 在 软件 完成 之 前 应 解决 的 问题 。 


F.4 程序 2( 标 识 符 ) 设 计 说 明 
用 类 似 F. 3 的 方式 ， 说 明 第 2 个 程序 乃至 第 N 个 程序 的 设计 考虑 。 


[| 
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附 录 G 


数据 库 设计 说 明 书 的 编写 提示 
(参考 件 ) 
G1 引言 
G. 1.1 编写 目的 
说明 编写 这 份 数据 库 设计 说 明 书 的 目的 ,指出 预期 的 读者 。 
G.1.2 背景 
说 明 : 


a. 说 明 待 开发 的 数据 库 的 名 称 和 使 用 此 数据 库 的 软件 系统 的 名 称 ; 
b. 列 出 该 软件 系统 开发 项 目的 任务 提出 者 .用 户 以 及 将 安装 该 软件 和 这 个 数据 库 的 计算 站 (中 
心 )。 
G.1.3 定义 
列 出 本 文件 中 用 到 的 专门 术语 的 定义 、 外 文 首 字母 组 词 的 原 词组 。 
_G.1.4 参考 资料 
列 出 有 关 的 参考 资料 ; 
a. 本 项 目的 经 核准 的 计划 任务 书 或 合同 、 上 级 机 关 批文 
y.。 属于 本 项 目的 其 他 已 发 表 的 文件 ; 
ec. 本 文件 中 各 处 引用 到 的 文件 资料 ,包括 所 要 用 到 的 软件 开发 标准 。 
列 出 这 些 文件 的 标题 .文件 编号 ,发表 日 期 和 出 版 单位 ,说明 能 够 取得 这 些 文件 的 来 源 。 
G. 2 外 部 设计 
“G.2.1 标识 符 和 状态 
联系 用 途 ,详细 说 明 用 于 唯一 地 标识 该 数据 库 的 代码 名称 或 标识 符 , 附 加 的 描述 性 信息 亦 要 给 出 。 
如 果 该 数据 库 属 于 尚 在 实验 中 、 尚 在 测试 中 或 是 暂时 使 用 的 ， 则 要 说 明 这 一 特点 及 其 有 效 时 间 范围 
G.2.2 使 用 它 的 程序 
列 出 将 要 使 用 或 访问 此 数据 库 的 所 有 应 用 程序 对 于 这 些 应 用 程序 的 每 一 个 ,给 出 它 的 名 称 和 版 本 
号 。 
G.2.3 约定 
陈述 一 个 程序 员 或 一 个 系统 分 析 员 为 了 能 使 用 此 数据 库 而 需要 了 和 解 的 建立 标号 .标识 的 约定 ,例如 
用 于 标识 数据 库 的 不 同 版 本 的 约定 和 用 于 标识 库 内 名 个 文 卷 .记录 .数据 项 的 命名 约定 等 。 
G.2.4 专门 指导 
向 准备 从 事 此 数据 库 的 生成 ,从事 此 数据 库 的 测试 ,维护 人 员 提 供 专门 的 指导 ,例如 将 被 送 入 数据 
库 的 数据 的 格式 和 标准 、 送 入 数据 库 的 操作 规程 和 步骤 ,用 于 产生 、 修 改 、 更 新 或 使 用 这 些 数据 文 卷 的 操 
作 指 导 。 
如 果 这 些 指导 的 内 容 篇 幅 很 长 ， 列 出 可 参阅 的 文件 资料 的 名 称 和 章 条 。 
G.2.5 支持 软件 
简单 介绍 同 此 数据 库 直 接 有 关 的 支持 软件 ， 如 数据 库 管 理 系 统 、 存储 定位 程序 和 用 于 装 入 、 生 成 . 修 
改 .更 新 数据 库 的 程序 等 .说 明 这 些 软件 的 名 称 .版 本 号 和 主要 功能 特性 ， 如 所 用 数据 模型 的 类 型 、 允 许 
的 数据 容量 等 . 列 出 这 些 支持 软件 的 技术 文件 的 标题 编号 及 来 源 。 
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G.3 结构 设计 


G. 53.1 概念 结构 设计 
说 明 本 数据 库 将 反映 的 现实 世界 中 的 实体 、 属性 和 它们 之 间 的 关系 等 的 原始 数据 形式 ， 包括 各 数据 
项 .记录 、 系 , 文 卷 的 标识 符 .定义 .类 型 、 度量 单位 和 值 域 建立 本 数据 库 的 每 一 幅 用 户 视图 。 
G. 3.2 逻辑 结构 设计 
说 明 把 上 述 原 始 数据 进行 分 解 、 合 并 后 重新 组 织 起 来 的 数据 库 全 局 逻辑 结构 ， 包括 所 确定 的 关键 字 
和 属性 、 重 新 确定 的 记录 结构 和 文 卷 结 构 、 所 建立 的 各 个 文 卷 之 间 的 相互 关系 ,形成 本 数据 库 的 数据 库 
管理 员 视 图 。 
G. 3.5 物理 结构 设计 
建立 系统 程序 员 视 图 ,包括 : 
a. 数据 在 内 存 中 的 安排 ,包括 对 索引 区 .缓冲 区 的 设计 |; 
b. 所 使 用 的 外 存 设 备 及 外 存 空间 的 组 织 ,包括 索 引 区 ,数据 块 的 组 织 与 划分 ; 
c. 访问 数据 的 方式 方法 。 


G. 4 运用 设计 
G. 4. 1 .数据 字典 设计 
对 数据 库 设计 中 涉及 到 的 各 种 项 目 , 如 数据 项 .记录 . 系 . 文 卷 .模式 . 子 模式 等 一 般 要 建立 起 数据 字 
典 , 以 说 明 它 们 的 标识 符 、 同 义 名 及 有 关 信 息 .在 本 节 中 要 说 明 对 此 数据 字典 设计 的 基本 考虑 。 
G.4.2 安全 保密 设计 


说 明 在 数据 库 的 设计 中 ,将 如 何 通 过 区 分 不 同 的 访问 者 、 不 同 的 访问 类 型 和 不 同 的 数据 对 象 ， 进行 
分 别 对 待 而 获得 的 数据 库 安 全 保密 的 设计 考虑 。 
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附 录 HH 


用 户 手册 的 编写 提示 
(参考 件 ) 
H.1 引言 
”H.1.1 编写 目的 
党 明 编 号 这 份 用 户 手 册 的 目的 ， 指出 预期 的 读者 。 
.1.2 背景 
说 明 


a, 这 份 用 户 手册 所 描述 的 软件 系统 的 名 称 ， 
b。 该 软件 项 目的 任务 提出 者 、 开发 者 、 用 户 (或 首 批 用 户 ) 及 安装 此 软件 的 计算 中 心 ， 
H.1.3 定义 
列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文 首 字母 组 词 的 原 词组 ， 
_H.1.4 参考 资料 : 
““ 列 出 有 用 的 参考 资料 ,如 : 
a. 本 项 目的 经 核准 的 计划 任务 书 或 合同 .上 级 机 关 的 批文 ; 
b. 属于 本 项 目的 其 他 已 发 表 文 件 ， 
ce. ”本 文件 中 各 处 引用 的 文件 ,资料 ,包括 所 要 用 到 的 软件 开发 标准 。 
” 列 出 这 些 文件 资料 的 标题 文件 编号 .发 表 日 期 和 出 版 单位 ,说 明 能 够 取得 这 些 文件 资料 的 来 源 。 
H.2 用 途 
H.2.1 功能 
结合 本 软件 的 开发 目的 逐 项 地 说 明 本 软件 所 具有 各 项 功能 以 及 它们 的 极限 范围 。 
z H. 2.2 性 能 
z H, 2. 2. 1 .精度 
”未 项 说 明 对 各 项 输入 数据 的 精度 要 求 和 本 软件 输出 数据 达到 的 精度 ， 包括 传输 中 的 精度 要 求 。 
了 .2. 2. 2 时 间 特 性 
定 基 地 说 明 本 软件 的 时 间 特 性 ,如 响应 应 时 间 ， 更 新 处 理 时 间 ， 数据 传输 、 转换 时 间 ， 计算 时 间 等 。 
H. 2.2.3 灵活 性 
说 明 本 软件 所 具有 的 灵活 性 ， 即 当 用 户 需求 (如 对 名作 方式. 运 运行 环境 、 结 果 精 度 、 时 间 特 性 等 的 要 
求 ) 有 某 些 变化 时 ,本 软件 的 适应 能 力 。 
H. 2.3 安全 保密 
说 明 本 软件 在 安全 、 保密 方面 的 设计 考虑 和 实际 达到 的 能 力 ， 


H. 5 运行 环境 


H. 3.1 硬 设 备 

列 出 为 运行 本 软件 所 要 求 的 硬 设备 的 最 小 配置， 如 : 

a. 处 理 机 的 型 号 内存 容量 ; 

b. “所 要 求 的 外 存储 器 .媒体 .记录 格式 、 设备 的 型 号 和 台数 、 联机 / 脱 机 ， 
LO 设备 (联机 / 脱 机 ?7; 
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d. 数据 传输 设备 和 转换 设备 的 型 号 .台数 。 
H. 3.2 支持 软件 
说 明 为 运行 本 软件 所 需要 的 支持 软件 ,如 ; 
a， 操作 系统 的 名 称 .版 本 号 ; 
“”b. 程序 语言 的 编译 /汇编 系统 的 名 称 和 版 本 号 ， 
c. ”数据库 管理 系统 的 名 称 和 版 本 号 ; 
d. ”其 他 支持 软件 。 
H. 3.3 数据 结构 
” 列 出 为 支持 本 软件 的 运行 所 需要 的 数据 库 或 数据 文 卷 。 


了 ,4 使 用 过 程 


在 本 章 ,首先 用 图 表 的 形式 说 明 软 件 的 功能 同系 统 的 输入 源 机 构 、 输出 接收 机 构 之 间 的 关系 。 
H. 4. 安装 与 初始 化 
一 步 一 步 地 说 明 为 使 用 本 软件 而 需 进行 的 安装 与 初始 化 过 程 ， 包括 程序 的 存储 形式 、 安装 与 初始 化 
过 程 中 的 全 部 操作 命令 .系统 对 这 些 命令 的 反应 与 答复 .表征 安装 工作 完成 的 测试 实例 等 .如 果 有 的 话 ， 
还 应 说 明 安装 过 程 中 所 需 用 到 的 专用 软件 。 
H. 4.2 输入 
规定 输入 数据 和 参量 的 准备 要 求 .。 
H. 4.2.1 输入 数据 的 现实 背景 
说 明 输 入 数据 的 现实 背景 ,主要 是 : 
“a. 情况 一 一 例如 人 员 变 动 .库存 缺 货 ; 
b. 情况 出 现 的 频 度 一 一 例如 是 周期 性 的 .随机 的 、 一 项 操作 状态 的 函数 ; 
c， 情况 来 源 一 一 例如 入 事 部 门 .仓库 管理 部 门 ; 
d4. 输入 媒体 一 一 例如 键盘 .穿孔 卡片 磁带: 
e. 限制 一 -出 于 安全 ,保密 考虑 而 对 访问 这 些 输入 数据 所 加 的 限制 ; 
f. 质量 管理 一 -例如 对 输入 数据 合理 性 的 检验 以 及 当 输 入 数据 有 错误 时 应 采取 的 措施 ， 如 建立 
出 错 情况 的 记录 等 ; 
”gg. ”支配 一 -例如 如 何 确 定 输入 数据 是 保留 还 是 废弃 ,是 否 要 分 配给 其 他 的 接受 者 等 。 
H. 4.2.2 输入 格式 
说 明 对 初始 输入 数据 和 参量 的 格式 要 求 ， 包括 语法 规则 和 有 关 约 定 ， 如 : 


A 





a, 
b. 并 式 基准 一 例如 以 左面 的 边 浪 为 基准 ; 
标号 一 一 例如 标记 或 标识 符 ; . 
顺序 一 一 例如 各 个 数据 项 的 次 序 及 位 置 ， 
标点 一 一 例如 用 来 表示 行 、 数 据 组 等 的 开始 或 结束 而 使 用 的 空格 、 斜 线 . 星 号 .字符 组 等 ， 
.词汇 表 一 一 给 出 允许 使 用 的 字符 组 合 的 列表 ,禁止 使 用 的 字符 组 合 的 列表 等 ， 
省 略 和 重复 一 一 给 出 用 来 表示 输入 元 紊 可 省 上 略 或 重复 的 表示 方式 ; 
.ih. 控制 一 -给 出 用 来 表示 输入 开始 或 结束 的 控制 信息 。 
H. 4.2.3 输入 举例 

为 每 个 完整 的 输入 形式 提供 样本 ,包括 : 

a， 控制 或 首部 一 例如 用 来 表示 输入 的 种 类 和 类 型 的 信息 ， 标识 符 输 入 日 期 ， 正文 起 点 和 对 所 用 
编码 的 规定 ; 

b. 主体 一 一 输入 数据 的 主体 ,包括 数据 文 卷 的 输入 表述 部 分 ， 


mn me pr 
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6， 示 输 入 结束 的 控制 信息 ,累计 字符 总 数 等 ; 
d. 省 赂 多 出 因此 条 入 才 据 是 可 和 的 
e 重复 一 一 指出 哪些 输入 数据 是 重复 的 。 
H. 4.5 输出 
对 每 项 输出 作出 说 明 。 
H. 4.3.1 输出 数据 的 现实 背景 
说 明 输 出 数据 的 现实 背景 ,主要 是 ， 
a. 使 用 一 一 这 些 输出 数据 是 给 谁 的 ,用 来 干什么 ， 
b. 使 用 频 度 一 一 例如 每 周 的 、 定 期 的 或 备查 阅 的 ， 
c， 媒体 一 一 打印 .CRI 显示、 磁带, 卡片 .磁盘 ，; 
d. 质量 管理 一 一 例如 关于 合理 性 检验 、 出 错 纠正 的 秽 定 ， 
e 文本 倍加 如 何 而 怎 葵 出 数据 是 保留 还 是 刻 奔 ， 是 否 要 分 配给 其 他 接受 者 等 。 
.4.35.2 输出 格式 
给 出 对 每 一 类 输出 信息 的 解释 ,主要 是 ， z 
a. 首部 一 一 如 输出 数据 的 标识 符 ,输出 日 期 和 输出 编号 ; 
b. 主体 一 一 输出 信息 的 主体 ,包括 分 栏 标题 
ec. 尾部 一 一 包括 累计 总 数 ,结束 标记 。 
”H.4.3.3 输出 举例 
为 每 种 输出 类 型 提供 例子 .对 例子 中 的 每 一 项 ,说 明 : 
a. ”定义 一 一 每 项 输出 信息 的 意义 和 用 途 ， 
b， 来 源 一 一 是 从 特定 的 输入 中 抽出 、 从 数据 库 文 卷 中 取出 、 或 从 软件 的 计算 过 程 申 得 到 ， 
ec， 特性 一 一 输出 的 值 域 .计量 单位 、 在 什么 情况 下 可 缺 省 等 ， 
H. 4.4 文 卷 查询 
这 一 条 的 编写 针对 具有 查询 能 力 的 软件 ,内 容 包 括 : : 同 数 据 库 查 询 有 关 的 初始 化 ,准备 、 及 处 理 所 需 
要 的 详细 规定 ,说 明 查 询 的 能 力 、 方 式 ， 所 使 用 的 命令 和 所 要 求 的 控制 规定 。 z 
H. 4. 5， 出错 处 理 和 恢复 
列 出 由 软件 产生 的 出 错 编码 或 条 件 以 及 应 由 用 户 承 担 的 修改 纠正 工作 ， 指出 为 了 确保 再 启 动 和 恢 
复 的 能 力 , 用 户 必须 遵循 的 处 理 过 程 。 
H. 4.6 终端 操作 
当 软 件 是 在 多 终端 系统 上 工作 时 ,应 编写 本 条 ,以 说 明 终端 的 配置 安排 .连接 步 释 、 数 据 和 参数 输入 
步 又 以 及 控制 规定 ,说 明 通过 终端 操作 进行 查询 .检索 .修改 数据 文 卷 的 能 力 、 语 言 . 过 程 以 及 辅助 性 程 
序 等 。 








GB 8567 一 88 


附 录 I 


”操作 手册 的 编写 提示 
(参考 件 ) 
141 引言 
I. 1.1 编写 目的 
说 明 编 写 这 份 操 作 手 册 的 目的 ,指出 预期 的 读者 。 
1.1.2 背景 
说 明 ， 


“ a. 这 份 操作 手册 所 描述 的 软件 系统 的 名 称 ; 
b， 该 软件 项 目的 任务 提出 者 .开发 者 ,用户 (或 首 批 用 户 ) 及 安装 该 软件 的 计算 中 心 。 
1.1.3 定义 
列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文 首 字母 组 词 的 原 词组 。 
1.1.4 参考 资料 
列 出 有 用 的 参考 资料 ,如 : 
a. 本 项 目的 经 核准 的 计划 任务 书 或 合同 .上 级 机 关 的 批文 ; 
b. 属于 本 项 目的 其 他 已 发 表 的 文件 ; - 
ce. ”本 文件 中 各 处 引用 的 文件 ,资料 ,包括 所 列 出 的 这 些 文件 资料 的 标题 ,文件 编号 ,发 表 日 期 和 出 
版 单位 ,说 明 能 够 得 到 这 些 文件 资料 的 来 源 。 


-2 软件 概述 


2 软件 的 结构 
合 软 件 系统 所 具有 的 功能 包括 输入 、 处 理 和 输出 提供 该 软件 的 总 体 结构 图 表 。 
1. 2 2 程序 家 
列 出 本 系统 内 每 个 程序 的 标识 符 ,编号 和 助 记名 。 
I.2.3 文 卷 表 
列 出 将 由 本 系统 引用 .建立 或 更 新 的 每 个 永久 性 文 卷 , 说明 它们 各 自 的 标识 符 、 编号 、 助 记名 ,存储 
媒体 和 存储 要 求 。 


工 3 安装 与 初始 化 


z 一 步 一 步 地 说 明 为 使 用 本 软件 而 需要 进行 的 安装 与 初始 化 过 程 ， 包括 程序 的 存 载 形 式 , 安 装 与 初始 
化 过 程 中 的 全 部 操作 命令 ,系统 对 这 些 命令 的 反应 与 答复 ,表征 安装 工作 完成 的 测试 实例 等 .如 果 有 的 
话 ,还 应 说 明 安装 过 程 中 所 需 用 到 的 专用 软件 。 


I. 4 运行 说 明 
所 谓 一 个 运行 是 指 提供 一 个 启动 控制 信息 后 ,直到 计算 机 系统 等 待 另 一 个 启 启动 控制 信息 时 为 止 的 
计算 机 系统 执行 的 全 部 过 程 。 
1. 4.1 运行 表 
列 出 每 种 可 能 的 运行 ,摘要 说 明 每 个 运行 的 目的 ,指出 每 个 运行 各 自 所 执行 的 程序 。 
1. 4.2 ”运行 步 又 
说 明 从 一 个 运行 转向 另 一 个 运行 以 完成 整个 系统 运行 的 步 台 


I. 
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4. 3 运行 1( 标 识 符 ) 说 明 


把 运行 1 的 有 关 信 息 ， 以 对 操 作 人 员 为 最 方便 最 有 用 的 形式 加 以 说 


工 . 


i. 


pd 


4. 35.1 运行 控制 

列 出 为 本 运行 所 需要 的 运行 流向 控制 的 说 明 。 

4.3.2 操作 信息 

给 出 为 操作 中 心 的 操作 人 员 和 管理 人 员 所 需要 的 信息 ,如 : 

a. 运行 目的 ; 

b. 操作 要 求 ; 

c. 启动 方法 ”如 应 请 启动 (由 所 过 到 的 请 求 信息 启动 )、 预 定时 间 启 动 …… 等 ， 
d. 预计 的 运行 时 间 和 解 题 时 间 ; 

e， 操作 命令 ; 

f。 与 运行 有 联系 的 其 他 事项 。 


.4.3.3 输入 -输出 文 郑 


提供 被 本 运行 建立 .更 新 或 访问 的 数据 文 卷 的 有 关 信 息 ,如 ， 

a- 文 卷 的 标识 符 或 标号 ; 

b. 记录 媒体 ; 

c. 存留 的 目录 表 ; 

d.。 文 卷 的 支配 ”如 确定 保留 或 废弃 的 准则 ,是 否 要 分 配给 其 他 接受 者 占用 硬 设 备 的 优先 级 以 及 


保密 控制 等 有 关 规 定 ， 


I 


I. 


4.5.4 输出 文 段 

提供 本 软件 输出 的 每 一 个 用 于 提示 、 说 明 、 或 应 答 的 文 段 ( 包 括 “ 菜 单 ” ) 的 有 关 信 息 ， 如 ， 
文 段 的 标识 答 

输出 媒体 (屏幕 显示 .打印 、………); 

文字 容量 ， 

分 发 对 象 ; 

e. 保密 要 求 。 

4. 3.5 输出 文 段 的 复制 

对 由 计算 机 产生 ,而 后 需 用 其 他 方法 复制 的 那些 文 段 提供 有 关 信 息 ， 知 : 
a.” 文 段 的 标识 符 ; 

复制 的 技术 手段 ， 

纸张 或 其 他 媒体 的 规格 ; 

装订 要 求 ; 


ep TD 


Oo 


“”e. 分 发 对 象 ; 


ft 复制 份 数 。 


1 4.5.6， 恢复 过 程 


说 明 本 运行 故障 后 的 恢复 过 程 。 


I. 4.4 运行 2( 标 识 符 ) 说 明 


用 与 本 手册 I. 4. 3 条 相 类 似 的 方式 介绍 为 一 个 运行 的 有 关 信息 ， 


1. 5 非常 规 过 程 


提供 有 关 应 急 操作 或 非常 规 操作 的 必要 信息 ， 如 出 错 处 理 操作 、 向 后 备 系统 的 切 澳 操作 以 及 其 他 必 


须 向 程序 维护 人 员 交待 的 事项 和 步骤 。 
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4.6 远程 操作 
如 果 本 软件 能 够 通过 远程 终端 控制 运行 , 则 在 本 章 说 明 通过 远程 终端 运行 本 软件 的 操作 过 程 。 
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附录 1 
模块 开发 卷宗 的 编写 提示 
(参考 件 ) 


J.1 标题 


软件 系统 名 称 和 标识 符 

模块 名 称 和 标识 符 (如 果 本 卷宗 包含 多 于 一 个 的 模块 ， 则 用 这 组 模块 的 功能 标识 代替 模块 名 ) 
程序 编制 员 签名 

卷宗 的 修改 文本 序号 

修改 完成 日 期 

卷宗 序号 (说 明 本 卷宗 在 整个 卷宗 中 的 序号 ) 

编排 日 期 (说 明 整 个 卷宗 最 近 的 一 次 编排 日 期 


J. 2 ”模块 开发 情况 表 


J.3 功能 说 明 
”扼要 说 明 本 模块 (或 本 组 模块 ) 的 功能 ,主要 是 输入 、 要 求 的 处 理 , 输 出 ,可 以 从 系统 设计 说 明 书 中 摘 
录 . 同 时 列 出 在 软件 需求 说 明 书 中 对 这 些 功能 的 说 明 的 章 、 条 、 款 。 
J. 4 设计 说 明 

说 明 本 模块 (或 本 组 模块 ) 的 设计 考虑 ,包括 

a. 在 系统 设计 说 明 书 中 有 关 对 本 模块 (或 本 组 模块 ) 设 计 考 虑 的 叙述 ,包括 本 模块 在 软件 系统 中 
所 处 的 层次 , 它 同 其 他 模块 的 接口 ; 

b. 在 程序 设计 说 明 书 中 有 关 对 本 模块 (或 本 组 模块 ) 的 设计 考虑 ,包括 本 模块 的 算法 、 处 理 流程 、 
牵涉 到 的 数据 文 卷 设计 限制 .驱动 方式 和 出 错 信息 等 ; 

c， 在 编制 目前 已 通过 全 部 测试 的 源 代码 时 实际 使 用 的 设计 考虑 。 


3. 5 . 源 代 码 清单 


要 给 出 所 产生 的 本 模块 (或 本 组 模块 ) 的 第 一 份 无 语法 错 的 源 代码 清单 以 及 已 通过 全 部 测试 的 当前 
有 效 的 源 代码 清单 。 


J 了 .6 测试 说 明 


说 明 直接 要 经 过 本 模块 (或 本 组 模块 ) 的 每 一 项 测试 ,包括 这 些 测试 各 自 的 标识 符 和 编号 .进行 这 些 
测试 的 目的 、 所 用 的 配置 和 输入 、 预 期 的 输出 及 实际 的 输出 。 


J.7 复审 的 结论 


把 实际 测试 的 结果 , 同 软 件 需 求 说 明 书 、 系 统 设计 说 明 书 、 程序 设计 说 明 书 中 规定 的 要 求 进行 比较 
和 给 出 结论。 
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附 录 K 


测试 计划 的 编写 提示 
” (参考 件 ) 
K.1 引言 
K.1.1 编写 目的 z 
说 明 本 测试 计划 的 具体 编写 目的 ,指出 预期 的 读者 范围 。 
K.1.2 背 蚌 


说 明 : 

a,， 本 测试 计划 所 从 属 的 软件 系统 的 名 称 ; 

b. 该 开发 项 目的 历史 ， 列 出 用 户 和 执行 此 项 目测 试 的 计算 中 心 ， 说 明 在 开始 执行 本 测试 计划 之 前 
必须 完成 的 各 项 工作 。 

K. 1.3 定义 

列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文 首 字母 组 词 的 原 词 组 。 

K. 1.4 参考 资料 

. 列 出 要 用 到 的 参考 资料 ,如 : 

a. 本 项 目的 经 核准 的 计划 任务 书 或 合同 .上 级 机 关 的 批文 ; 

b， 属于 本 项 目的 其 他 已 发 表 的 文件 ; 

c. 本 文件 中 各 处 引用 的 文件 ,资料 ,包括 所 要 用 到 的 软件 开发 标准 。 

列 出 这 些 文件 的 标题 、 文 件 编号 、 发 表 日 期 和 出 版 单位 ,说 明 能 够 得 到 这 些 文件 资料 的 来 源 。 


K.2 计划 


K.2.1 软件 说 明 
提供 一 份 图 表 ， 并 过 项 说 明 被 测 软 件 的 功能 、 输入 和 输出 等 质量 指标 ， 作为 叙述 测试 计划 的 提纲。 
K. 2.2 测试 内 容 
列 出 组 装 测试 和 确认 测试 中 的 每 一 项 测试 内 容 的 名 称 标识 符 . 这 些 测试 的 进度 安排 以 及 这 些 测试 
的 内 容 和 目的 ,例如 模块 功能 测试 .接口 正确 性 测试 ,数据 文 卷 存 取 的 测试 .运行 时 间 的 测试 .设计 约束 
和 极限 的 测试 等 。 
K.2.3 测试 1( 标 识 符 ) . 
给 出 这 项 测试 内 容 的 参与 单位 及 被 测试 的 部 位 。 
K. 2. 3. 1 进度 安排 
给 出 对 这 项 测试 的 进度 安排 ， 包括 进行 测试 的 日 期 和 工作 内 容 (如 熟悉 环境 . 培 培训 、 准备 输入 数据 
等 )。 
XK.2.3.2 条 件 
陈述 本 项 测试 工作 对 资源 的 要 求 ， 包括 ， 
a. 设备 ”所 用 到 的 设备 类 型 .数量 和 预定 使 用 时 间 ; 
b. 软件 ” 列 出 将 被 用 来 支持 本 项 测试 过 程 而 本 身 又 并 不 是 被 测 软件 的 组 成 部 分 的 软件 ,如 测试 
驱动 程序 .测试 监控 程序 .仿真 程序 、. 桩 模块 等 等 ; 
c， 人 员 ” 列 出 在 测试 工作 期 间 预 期 可 由 用 户 和 开发 任务 组 提供 的 工作 人 员 的 人 数 、 技 术 水 平 及 
有 关 的 预备 知识 ,包括 一 些 特殊 要 求 , 如 倒班 操作 和 数据 键入 人 员 。 
K. 2. 3.3 测试 资料 z 
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列 出 本 项 测试 所 需 的 资料 ,如 : 

a， 有关 本 项 任务 的 文件 ， 

b. 被 测试 程序 及 其 所 在 的 媒体 ; 

ec. 测试 的 输入 和 输出 举例 ; 

d. 有 关 控 制 此 项 测试 的 方法 .过 程 的 图 表 。 
K.2.3.4 测试 培训 

说 明 或 引用 资料 说 明 为 被 测 软件 的 使 用 提供 培训 的 计划 ,规定 培训 的 内 容 、 受 训 的 人 员 及 从 事 培训 
的 工作 人 员 。 
K. 2.4 测试 2( 标 识 符 ) 

用 与 本 测试 计划 K. 2. 3 条 相 类 似 的 方式 说 明 用 于 另 一 项 及 其 后 各 项 测试 内 容 的 测试 工作 计划 。 


K.3 测试 设计 说 明 
K. 3.1 测试 1( 标 识 符 ) 
说 明 对 第 一 项 测试 内 容 的 测试 设计 考 感 ， 
K. 3.1.1 控制 
说 明 本 测试 的 控制 方式 ,如 输入 是 人 工 .半自动 或 自动 引入 、 控制 操作 的 顺序 以 及 结果 的 记录 方法 。 
K. 3.1.2 输入 
说 明 本 项 测试 中 所 使 用 的 输入 数据 及 选择 这 些 输入 数据 的 策略 。 
K. 3.1.3 输出 
说 明 预 期 的 输出 数据 ,如 测试 结果 及 可 能 产生 的 中 间 结 晕 或 运行 信息 ， 
K. 3.1.4 过 程 
说 明 完成 此 项 测试 的 一 个 个 步骤 和 控制 命令 ， 包括 测试 的 准备 、 初始 化 、 中 间 步 聚 和 运行 结 东方 式 。 
K, 3.2 ”测试 2( 标 识 符 ) 
用 与 本 测试 计划 K. 3. 1 条 相 类 似 的 方式 说 明 第 2 项 及 其 后 各 项 测试 工作 的 设计 考虑 。 


K. 4 评价 准则 


K. 4.1 范围 
说 明 所 选择 的 测试 用 例 能 够 检查 的 范围 及 其 局 限 性 。 
K. 4.2 数据 整理 
陈述 为 了 把 测试 数据 加 工 成 便于 评价 的 适当 形式 ,使 得 测试 结果 可 以 同 已 知 结果 进行 比较 而 要 用 
到 的 转换 处 理 技术 ,如 手工 方式 或 自动 方式 ;如 果 是 用 自动 方式 整理 数据 ,还 要 说 明 为 进行 处 理 而 要 用 
到 的 硬件 .软件 资源 。 
K. 4.3 尺度 
党 明 用 来 判断 测试 工作 是 否 能 通过 的 评价 尺度 ， 各 合理 的 输出 结果 的 类型 测试 输出 结果 与 预期 输 
出 之 间 的 容许 偏离 范围 、 允许 中 断 或 停机 的 最 大 次 数 。 
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附 录 L 
测试 分 析 报 告 的 编写 提示 
(参考 件 ) 
L.1 引言 
L.1.1 编写 且 的 
说 明 这 份 测试 分 析 报 告 的 具体 编写 目的 ,指出 预期 的 阅读 范围 。 
L.1.2 背景 


说 明 : 
a. 被 测试 软件 系统 的 名 称 ; 
b. 该 软件 的 任务 提出 者 .开发 者 ,用户 及 安装 此 软件 的 计算 中 心 ,指出 测试 环境 与 实际 运行 环境 
之 间 可 能 存在 的 差异 以 及 这 些 差异 对 测试 结果 的 影响 。 
L.1.3 定义 z 
列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文 背 字母 组 词 的 原 词组 。 
L. 1.4 参考 资料 
列 出 要 用 到 的 参考 宽 料 ,如 ; 
a 本 项 目的 经 核准 的 计划 任务 书 或 合同 .上 级 机 关 的 批文 ; 
b， 属于 本 项 目的 其 他 已 发 表 的 文件 ; 
c. 本 文件 中 各 处 引用 的 文件 .资料 ,包括 所 要 用 到 的 软件 开发 标准 。 
列 出 这 些 文件 的 标题 .文件 编号 ,发表 日 期 和 出 版 单位 ,说 明 能 够 得 到 这 些 文件 资料 的 来 源 。 


L.2 测试 概要 
用 表格 的 形式 列 出 每 一 项 测试 的 标识 符 及 其 测试 内 容 , 并 指明 实际 进行 的 测试 工作 内 容 与 测试 计 
划 中 预先 设计 的 内 容 之 间 的 差别 ,说 明 作 出 这 种 改变 的 原因 。 


L.3 测试 结果 及 发 现 
L. 5.1 测试 1( 标 识 符 ) 
把 本 项 测试 中 实际 得 到 的 动态 输出 (包括 内 部 生成 数据 输出 ) 结 果 同 对 于 动态 输出 的 要 求 进行 比 


较 ,陈述 其 中 的 各 项 发 现 。 
L. 3.2 测试 2( 标 识 符 ) 
用 类 似 本 报告 L. 3. 1 条 的 方式 给 出 第 2 项 及 其 后 各 项 测试 内 容 的 测试 结果 和 发 现 。 


L.4 对 软件 功能 的 结论 


L. 4. 1 功能 1( 标 识 符 ) 
L.4.1.1 能 力 

简 述 该 项 功能 ,说 明 为 满足 此 项 功能 而 设计 的 软件 能 力 以 及 经 过 一 页 或 多 项 测试 已 证 实 的 能 力 。 
. 工 .4.1.2 限制 

说 明 测试 数据 值 的 范围 (包括 动态 数据 和 静态 数据 )， 列 出 就 这 项 功能 而 言 ,测试 期 间 在 该 刻 软 件 中 查 
出 的 缺陷 、 局 限 性 。 
上. 4.2 功能 2( 标 识 符 ) 
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用 类 似 本 报告 L. 4. 1 的 方式 给 出 第 2 项 及 其 后 各 项 功能 的 测试 结论 。 


L.5 分 析 摘 要 


L.5.1 能 力 . 

陈述 经 测试 证 实 了 的 本 软件 的 能 力 。 如 果 所 进行 的 测试 是 为 了 验证 一 项 或 几 项 特定 性 能 要 求 的 实 
现 ,应 提供 这 方面 的 测试 结果 与 要 求 之 间 的 比较 ,并 确定 测试 环境 与 实际 运行 环境 之 间 可 能 存在 的 差异 
”对 能 力 的 测试 所 带 来 的 影响 。 | 

L. 5. 2 ”缺陷 和 限制 

陈述 经 测试 证 实 的 软件 缺陷 和 限制 ,说 明 每 项 缺陷 和 限制 对 软件 性 能 的 影响 ,并 说 明 全 部 测 得 的 性 

能 缺陷 的 累积 影响 和 总 影响 。 z 
L. 5.3 建议 

对 每 项 缺陷 提出 改进 建议 ,如 ; 

a 各 项 修改 可 采用 的 修改 方法 ， 

b. 各 项 修改 的 紧迫 程度 ， 

ec 各 项 修改 预计 的 工作 量 ， 

d. 各 项 修改 的 负责 人 。 
L. 5.4 评价 . 

说 明 该 项 软件 的 开发 是 否 已 达到 预定 目标 ,能 否 交付 使 用 。 


L.6 测试 资源 消耗 
总 结 测试 工作 的 资源 消耗 数据 ,如 工作 人 员 的 水 平 级 别 数量 .机 时 消耗 等 ， 
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“附录 M 
”开发 进度 月 报 的 编写 提示 
(参考 件 ) 


M.1 标题 
开发 中 的 软件 系统 的 名 称 和 标识 符 
分 项 目 名 称 和 标识 符 
“ 分 项 目 负 责 人 签名 
本 期 月 报 编写 人 签名 
本 期 月 报 的 编号 及 所 报告 的 年 月 


M. 2 工程 进度 与 状态 


M.2.1 进度 
列 出 本 月 内 进行 的 各 项 主要 活动 ,并 且说 明 本 月 内 遇 到 的 重要 事件 ,这 里 所 说 的 重要 事件 是 指 一 个 
开发 阶段 ( 即 软件 生存 周期 内 各 个 阶段 中 的 某 一 个 ,例如 需求 分 析 阶 段 ) 的 开始 或 结束 ,要 说 明 阶段 名 称 
及 开始 (或 结束 ) 的 日 期 。 
M. 2.2 状态 
说 明 本 月 的 实际 工作 进度 与 计划 相 比 ， 是 提前 了 、 按期 完成 了 、 或 是 推迟 了 ?如 果 与 计划 不 一 致 ,说 
明 厌 因 及 准备 采取 的 措施 。 


_M.5 资源 耗 用 与 状态 


M. 3.1 资源 砂 用 

主要 说 明 本 月 份 内 耗 用 的 工时 与 机 时 。 
M. 3.1.1 工时 : 

分 为 三 类 : 

a.、 管理 用 工时 “包括 在 项 目 管理 (制订 计划 布置 工作 ,收集 数据 .检查 汇报 工作 等 方面 耗 用 的 
工时 ; 

b. 服务 工时 ”包括 为 支持 项 目 开 发 所 必须 的 服务 工作 及 非 直接 的 开发 工作 所 耗 用 的 工时 ; 

c， 开发 用 工时 ”要 分 各 个 开发 阶段 填写 。 
M.3.1.2 机 时 

说 明 本 月 内 耗 用 的 机 时 ,以 小 时 为 单位 ， 说 明 计算 机 系统 的 型 号 。 
M. 3.2 状态 

说 明 本 月 内 实际 耗 用 的 资源 与 计划 相 比 ,是 超出 了 、 相 一 致 .还 是 不 到 计划 数 ? 如 果 与 计划 不 一 致 ， 
说 明 原 因 及 准备 采取 的 措施 。 


M. 4 经费 支出 与 状态 


M. 4.1 经 费 支出 
M. 4.1.1 支持 性 费用 
列 出 本 月 内 支出 的 支持 性 费用 ， 一 般 可 按 如 下 七 类 列 出 ， 并 给 出 本 月 支持 费用 的 总 和 : 
房租 或 房屋 折旧 费 ; 
b 工资 .奖金 .补贴 ; 
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培训 费 包括 给 教师 的 酬金 及 教室 租金 ; 
资料 费 包括 复印 及 购买 参考 资料 的 费用 ， 
会 议 费 ”召集 有 关 业 务 会 议 的 费用 ， 
旅 差 费 ， 
其 他 费用 。 
M. 4.1.2 设备 购置 费 
” 列 出 本 月 内 支出 的 设备 购置 费 ,一 般 可 分 如 下 三 类 : 
a. 购买 软件 的 名 称 与 金额 ; 
b. 购买 硬 设备 的 名 称 、 型 号 .数量 及 金额 ; 
c， 已 有 硬 设备 的 折 提 费 。 
M. 4.2 状态 
说 明 本 月 内 实际 支出 的 经 费 与 计划 相 比 较 , 是 超过 了 、 相符 合 、 还 是 不 到 计划 数 ? 如 果 与 计划 不 一 
致 ,说 明 原因 及 准备 采取 的 措施 。 


M.5 下 个 月 的 工作 计划 


mR mo a 0 


M.6 建议 
本 月 遇 到 的 重要 问题 和 应 引起 重视 的 问题 以 及 因此 产生 的 建议 。 
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附 录 N 


项 目 开 发 总 结 报告 的 编写 提示 
(参考 件 ) 
N.1 引言 
N. 1.1 编写 目的 
说 明 编写 这 份 项 目 开发 总 结 报告 的 目的 ,指出 预期 的 阅读 范围 。 
N.1.2 和 背景 


说 明 : 

a. ”本 项 目的 名 称 和 所 开发 出 来 的 软件 系统 的 名 称 ， 

b. 此 软件 的 任务 提出 者 、 开 发 者 .用 户 及 安装 此 软件 的 计算 中 心 。 
N.1.3 定义 

列 出 本 文件 中 用 到 的 专门 术语 的 定义 和 外 文 首 字母 组 词 的 原 词组 ， 
N. 1.4 参考 资料 

列 出 要 用 到 的 参考 资料 ,如 : 

.a. 本 项 目的 已 核准 的 计划 任务 书 或 合同 、 上 级 机 关 的 批文 ， 

b. 属于 本 项 目的 其 他 已 发 表 的 文件 ; 

ce. 本 文件 中 各 处 所 引用 的 文件 .资料 ,包括 所 要 用 到 的 软件 开发 标准 。 
列 出 这 些 文件 的 标题 ,文件 编号 ,发 表 日 期 和 出 版 单位 ,说 明 能 够 得 到 这 些 文件 资料 的 来 源 。 


N.2 实际 开发 结 采 


N. 2. 1 产品 
说 明 最 终 制 成 的 产品 ,包括 : 
a. 程序 系统 中 各 个 程序 的 名 字 , 它 们 之 间 的 层次 关系 ， 以 千 字 节 为 单位 的 各 个 程序 的 程序 量 、 存 
储 媒 体 的 形式 和 数量 ; 
b. 程序 系统 共有 哪 几 个 版 本 ,各 自 的 版 本 号 及 它们 之 间 的 区 别 ; 
c. 每 个 文件 的 名 称 ， 
d. 所 建立 的 每 个 数据 库 。 
如 果 开 发 中 制订 过 配置 管理 计划 ,要 同 这 个 计划 相 比 较 。 
N. 2.2 主要 功能 和 性 能 
逐 项 列 出 本 软件 产品 所 实际 具有 的 主要 功能 和 性 能 ,对 照 可 行 性 研究 报告 .项 目 开 发 计划 功能 需 
求 说 明 书 的 有 关内 容 ,说明 原 定 的 开发 目标 是 达到 了 、 未 完全 达到 、 或 超过 了 。 
N.2.3 基本 流程 
用 图 给 出 本 程序 系统 的 实际 的 基本 的 处 理 流程。 
N.2.4 进度 
列 出 原 定 计 划 进 度 与 实际 进度 的 对 比 ,明确 说 明 ,实际 进度 是 提前 了 、 还 是 延迟 了 ,分析 主 要 原因 。 
”N.2.5 费用 
列 出 原 定 计划 费用 与 实际 支出 费用 的 对 比 ,包括 : 
a. 工时 ,以 人 月 为 单位 ,并 按 不 同 级 别 统计 ， 
b. 计算 机 的 使 用 时 间 , 区 别 CPU 时 间 及 其 他 设备 时 间 ， 
c. 物料 消耗 .出 差 费 等 其 他 支出 。 
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明确 说 明 ,经 费 是 超出 了 、 还 是 节余 了 ,分析 其 主要 原因 。 
N. 5 开发 工作 评价 


，N.3.1 对 生产 效率 的 评价 
”给 出 实际 生产 效率 ,包括 : 
a. ”程序 的 平均 生产 效率 , 即 每 人 月 生产 的 行 数 ， 
b. 文件 的 平均 生产 效率 , 即 每 人 月 生产 的 千 字 数 ; 
并 列 出 原 订 计划 数 作为 对 比 。 
N. 3.2， 对 产品 质量 的 评价 
说 明 在 测试 中 检查 出 来 的 程序 编制 中 的 错误 发 生 率 , 邵 每 千 条 指令 (或 语句 ) 中 的 错误 指令 数 ( 或 语 
句 数 ) .如 果 开 发 中 制订 过 质量 保证 计划 或 配置 管理 计划 ,要 同 这些 计 划 相 比较 。 
N.3.3 对 技术 方法 的 评价 z 
给 出 对 在 开发 中 所 使 用 的 技术 .方法 .工具 .手段 的 评价 。 
N. 3.4 出 错 原 因 的 分 析 
给 出 对 于 开发 中 出 现 的 错误 的 原因 分 析 。 


N.4 经 验 与 教训 
列 出 从 这 项 开发 工作 中 所 得 到 的 最 主要 的 经 验 与 教训 及 对 今后 的 项 目 开 发 工作 的 建议 。 
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附 录 0 
文件 编制 实施 规定 的 实例 
(参考 件 ) 


尽管 在 文件 编制 中 存在 着 很 多 灵活 性 ,然而 ,文件 的 编制 确实 是 非常 必要 的 ,其 意义 如 前 所 述 .为 了 
控制 这 种 灵活 性 ,保证 文件 编制 能 达到 应 该 达到 的 目的 ,对 于 具体 的 软件 开发 任务 ,应 编制 的 文件 的 种 
类 .详细 程度 应 取决 于 承担 开发 单位 的 管理 能 力 、 任 务 的 规模 、 复 杂 性 和 成 败 风 险 等 因素 ,一 个 软件 开发 
单位 应 该 根据 本 单位 经 营 承 包 的 应 用 软件 的 专业 特点 和 本 单位 的 管理 能 力 , 制 定 一 个 文件 编制 实施 规 
定 , 说 明 在 什么 情况 下 应 该 编制 哪些 文件 由 于 国内 目前 在 这 方面 还 缺乏 成 熟 的 经 验 , 这 里 提供 参考 国 
外 经 验 制定 的 两 个 例子 ,用 以 向 国内 软件 开发 单位 说 明 如 何 建立 这 种 实施 规定 ,使 项 目 负 责 人 能 确定 本 
项 目 开发 过 程 中 应 编制 的 文件 的 种 类 .当然 ,例子 毕竟 只 是 例子 ,这 两 个 例子 各 自 都 不 免 有 其 片面 性 , 它 
们 两 者 之 间 也 不 免 有 不 一 致 之 处 ,之 所 以 列 出 来 无 非 是 供 国内 软件 开发 单位 参考 。 

例 1: 

此 例 规定 用 求 和 法 来 确定 应 编制 的 文件 。 该 方法 的 要 点 是 提出 十 二 个 考虑 因素 来 衡量 一 个 应 用 软 
件 , 每 个 因素 可 能 取 值 的 范围 是 1 至 5. 任 务 负责 人 可 用 这 十 二 个 因素 对 所 要 开发 的 程序 进行 衡量 ,确定 
每 个 因素 的 具体 值 , 把 这 十 二 个 因素 的 值 相 加 ,得 到 一 个 总 和 ,。 然 后 由 这 个 总 和 的 值 来 确定 应 该 编制 的 
文件 的 种 类 。 使 用 这 个 方法 的 具体 过 程 如 下 : - 

a.、 按 表 01 中 的 十 二 个 因素 衡量 所 要 开发 的 程序 ,得 到 每 个 因素 的 值 ; 

b. 把 衡量 所 得 的 各 个 因素 的 值 相 加 ,得 总 和 之 值 ; 

c. 根据 总 和 之 值 ,从 表 02 查 出 应 编制 的 文件 的 种 类 。 

表 0o1 文件 编制 的 十 二 项 衡量 因素 


因 过 取 值 准 则 


四 没有 一 在 不 : 
很 少 一 一 具有 有 限 一 一 具有 相当 多 一 一 应 重大 的 一 一 应 
1 1 相 t 上 
创造 性 要 求 | 看 纺 更 严格 的 要 求 新 的 接口 用 现 有 的 技巧 用 先进 的 技巧 










有 限 的 灵活 性 | 多 用 途 、 灵 活 ey 

2 ; : 有 一 个 | 
能 的 范围 是 参 | 允许 格式 上 有 | 的 格式 有 一 个 上 处 理 范围 广 

泛 的 主题 


Uns 多 , 标 


单机 、 常 规 处 主机 控制 系 
5 | ”设备 复杂 性 ”| 单机 .常规 处 理 | 理 ,扩充 的 外 spied oi 统 ,多 机 ,自动 
z 设 系统 | MO 和 显示 
6 人 
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30 人 年 以 上 





“3 人 年 至 10 人 
年 


常规 过 程控 制 | 人 身 安全 





国家 安危 
"| oo 
”| 高 级 语言 带 一 | 高 级 语言 带 相 

a | | 


表 02 各 项 因素 总 和 同文 件 编制 要 求 的 关系 
































( 酒 总 班 寥 


可 | 项 | 软 | 数 | 概 | 详 | 数 | 用 模 | 测 | 测 | 项 | 天 
行 | 目 | 件 | 据 | 要 | 细 | 据 | 户 岂 | 试 | 试 | 目 | 发 
因 | 性 | 开 | 需 | 要 | 设 | 设 | 库 | 手 | 开 | 计 | 分 | 开 | 进 
研 | 发 | 求 | 求 | 计 | 计 | 设 | 姑 发 | 划 | 析 | 发 | 问 
素 | 究 | 计 | 说 | 说 | 说 | 说 | 计 | 或 着 报 | 总 |. 月 
报 | 划 | 明 | 胡 -| 明 | 明 | 说 | 宗 告 | 结 | 报 
总 | 告 ， 书 | 书 | 书 | 书 | 明 报 | 
| : 书 告 
可 





12~18* 

16~26 

24~38 
36~50 
48~60 


<< 人 《< 


* 在 因素 总 和 较 低 的 情况 下 ,项 目 开发 总 结 报告 的 内 容 应 包括 :程序 的 主要 功能 .基本 流程 .测试 结果 和 使 用 说 明 。 
* # 测试 分 析 报 告 应 该 写 , 但 不 必 很 正规 ， 
* # # 数据 要 求 说 明和 数据 库 设 计 说 明 是 否 需 要 编写 应 根据 所 开发 软件 的 实际 需要 来 决定 。 
例 2: 
为 了 避免 在 软件 开发 中 文件 编制 的 不 足 或 过 分 ,一 个 简便 的 办 法 是 把 对 软件 文件 的 编制 要 求 同 软 
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件 的 规模 大 小 联系 起 来 ,这 就 是 本 例 的 出 发 点 。 软 件 的 规模 不 妨 分 为 四 级 : 

1. 小 规模 软件 。“ 源 程序 行 数 小 于 5 000 的 软件 ， 

2. 中 规模 软件 。“” 源 程序 行 数 为 10 000~50 000 的 软件 ， 

3. 大 规模 软件 。“ 源 程序 行 数 为 100 000~ 500 000 的 软件 ， 

4. 特大 规模 软件 ” 源 程序 行 数 大 于 500 000 的 软件 。 

对 上 述 的 四 级 软件 的 文件 编制 要 求 分 别 列 于 表 03。 
” ”至 于 源 程序 行 数 为 5 000~~10 000,50 000 一 100 000 的 软件 ,其 文件 编制 要 求 介 于 两 级 之 间 , 可 根 
据 一 个 软件 产品 的 具体 情况 ,由 项 目 负责 人 参照 表 03 的 规定 ,确定 需要 编制 的 文件 种 类 。 

对 于 源 程序 行 数 大 于 500 000 的 特大 规模 软件 ,可 进一步 把 本 指南 规定 的 十 四 种 文件 按 实 际 需要 
扩展 成 更 多 种 类 ,这 一 点 在 本 指南 5. 3. 3 已 经 提 到 。 


小 规模 软件 中 规模 软件 
项 目 开发 计划 
软件 需求 与 开发 计划 
z z 软件 需求 说 明 
测试 计划 
软件 设计 说 明 软件 设计 说 明 
使 用 说 明 ”使 用 说 明 
模块 开发 卷宗 
测试 分 析 报 告 人 
试 分 析 报 告 
开发 进度 用 报 
项 目 开发 总 结 
附加 说 明 ， 
本 标准 由 中 华人 民 共和 国电 子 工业 部 提出 。 
本 标准 由 中 国 软件 技术 公司 负责 起 草 。 
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家 03 产品 文件 体系 


”项 目 开发 总 结 


本 标准 主要 起 草 人 应 明 、 崔 涛 、 刘 林 。 


大 规模 软件 特大 规模 软件 


件 所 规定 的 文件 


人 对 应 于 大 规模 软 
项 目 开 发 计划 ”可 进一步 细 分 


数据 要 求 说 明 


-测试 计划 


详细 设计 说 明 


[mt 
数据 库 设计 说 明 


人 
作 手 册 
模块 开发 卷宗 


测试 分 析 报告 


开发 进度 月 报 


项 目 开发 总 结 


